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Foreword 


This document is a compendium of the WFF TOPEX Software Development Team's 
knowledge regarding Altimeter Instrument File (AIF) Processing. It includes many 
elements of a Requirements Document, a Software Specification Document, a Soft- 
ware Design Document, and a User's Manual. In the more technical sections, this 
document assumes the reader is familiar with TOPEX and Instrument files. 
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Section 1 

Introduction 


1.1 Purpose 

This document provides a detailed description of TOPEX Altimeter Instrument File 
(AIF) Processing at NASA Goddard Space Flight Center's Wallops Flight Facility 
(WFF). AIF Processing is work-in-progress and this document will be updated to 
reflect changes in the documented software or procedures. 

1 .2 Scope 

This document is Volume 3 in a series of publications generated by the TOPEX Soft- 
ware Development Team (SWDT) at WFF. Volume 1 is an overview of the project and 
its processes. Volume 2 documents pre-launch Radar Altimeter System Evaluator 
(RASE) processing. Volumes 4 and 5 document Sensor Data Record (SDR) and Geo- 
physical Data Record (GDR) processing, respectively. Volume 6 covers Special Pro- 
cessing which does not fall into any of the other categories. The series is an attempt to 
document SWDT software and procedures used in support of TOPEX at WFF. 

1.3 Organization of Document 

Section 2 lists other documents related to this document. Section 3 describes Altime- 
ter Instrument Files. Sections 4, 5 and 6 document Daily, Weekly, and Special Process- 
ing, respectively. Section 7 details the components of AIF processing. Appendix A 
contains samples of AIF Standard Products. Appendix B lists programs and software 
used and developed. Appendix C describes the contents of AIF output files and data- 
bases. Appendix D has plots of reference values used in AIF Processing. Appendix E 
is the change history of AIF processing software. Appendix F contains significant 
documents and memos related to AIF Processing. 
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Section 2 

Related Documentation 
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Selected documents and memos are also included in Appendix F-Attachments for 
completeness. 
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Section 3 

Altimeter Instrument Files 


3.1 Definition 

Altimeter Instrument Files (AIFs) are created daily by the TOPEX Ground System 
(TGS) at the Jet Propulsion Laboratory (JPL). These files provide WFF with the most 
immediate look at the health and status of the TOPEX altimeter. The flow of altimeter 
data is depicted in'Figure 3-1 'TOPEX ALT Dataflow (AIF Emphasized)", where 
emphasis is placed on the AIF data flow. 

The TOPEX Ground System extracts altimeter science and engineering minor frames 
from the spacecraft telemetry. Common frames are merged and time-sorted to create 
AIFs. AIFs are created in eight-hour segments usually corresponding to a play-back 
period. WFF users may request that segments of less than eight hours be created and 
made available on a special by-request basis. 

At the end of a UTC day, the three eight-hour segments are merged into one twenty- 
four hour file and placed in a shared storage area on TGSC. For a complete descrip- 
tion of the AIF formats, see TPL D-7925 TOPEX Ground System Software Interface 
Specification (STS-2) Instrument File . 

3.2 Distribution 

Altimeter Instrument Files are made accessible to WFF via the NASA Science Internet 
(NSI) using either DECNET or FTP protocols. WFF does not redistribute AIFs. 

3.3 Storage 

A full set of twenty-four hour AIF science and engineering files consumes approxi- 
mately 105 megabytes of disk space. A week of instrument files is kept in the working 
area at WFF. Instrument files over a week old are rolled off onto 2.2GB Exabyte tape 
for archive. Every AIF generated has been archived and is available for use at WFF. 
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Section 4 

AIF Daily Processing 


AIFs are automatically retrieved from JPL and processed by WFF. The daily process- 
ing script, autoaif, is executed each day at 0800 UTC by the UNIX crontab facility. 
The timing is set up such that when WFF personnel arrive to work, all daily process- 
ing is complete and the standard products are available for inspection. See Figure 4-1 
"TOPEX AIF Daily Processing" for diagram of daily processing. Appendix A contains 
samples of the daily products produced by autoaif. autoaif performs the following 
functions (in order). 

• Runs ftpjplbin, which uses FTP to transfer Science, Engineering, and Selected 
Telemetry Record (STR) AIF files from JPL via NSl/ SPAN. If the transfer is not 
successful, the program will retry the copy 300 times with a 180 second time- 
out between copies. A log is kept of the processing; upon completion, this log 
is electronically mailed to the user who invoked the process. See Figure A-1 
"AIF Processing Log Produced as Part of Daily Processing". 

• Runs dotelem, the primary data reduction program. It creates 15-second Sci- 
ence Averages, Event Listings, 5-minute Engineering Averages, and CAL, 
Engineering, Waveform, and Header database import files. 

• Runs aifhdr, a UNIX script that runs the IDL program aifhdnpro to read the 
dotelem Event Listing and generate a Processing Summary report. See Figure 
A-2 "AIF Processing Summary Produced as Part of Daily Processing". 

• Runs aifcal, a UNIX script that runs the IDL program aifcal.pro to read the 
dotelem database CAL We and create Daily AIF CAL plots. See Figure A-3 
"AIF CAL Plot Produced as Part of Daily Processing". 

• Runs dailyeng, a UNIX script that runs the IDL program dailyeng.pro to read 
the dotelem Engineering Averages file and create Daily AIF Engineering plots. 
See Figure A-4 "AIF Engineering Plot Produced as Part of Daily Processing". 

• Runs aifsci, a UNIX script that runs the IDL program aifsci.pro to read the 
dotelem Science Averages file and create Daily AIF Engineering plots. See Fig- 
ure A-5 "AIF Science Plots Produced as Part of Daily Processing". 

• Runs dailywf, a UNIX script that runs the IDL program wfdiff.pro to read the 
dotelem database Waveform files and create Daily AIF Waveform Difference 
plots. See Figure A-6 "AIF Waveforms Difference Plot Produced as Part of 
Daily Processing". 

• Prints the dotelem Events Listing. See Figure A-7 "AIF Events Report Pro- 
duced as Part of Daily Processing". 

• Concatenates the dotelem database files into the corresponding merged AIF 
database file in / gen / topex2/ dbase. 

• Moves the AIF files into /gen/ flight/ aif, the AIF Storage area. 
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Section 5 

AIF Weekly Processing 


Each week, the merged AIF database files are copied to the TOPEX Macintosh 
Quadra 900 and imported into the AIF Databases. After this is done, all data in the 
databases are exported to create Launch-to-Date files. The Launch-to-Date files are 
copied back to osb3 and the UNIX script launchtodate is run. launchtodate runs IDL 
programs that create the standard Launch-to-Date plots. The diagram for weekly AIF 
processing is shown in Figure 5-1 "TOPEX AIF Weekly Processing". Appendix A con- 
tains samples of the weekly products, launchtodate performs the following functions 
(in order). 

• Runs dbcal, a UNIX script that runs the IDL program aifcal.pro to read the 
database extraction CAL file and create Launch-to-Date AIF CAL plots. See 
Appendix A, Figure A-8 "Launch-to-Date CAL Plot Produced as Part of 
Weekly Processing". 

• Runs dbeng, a UNIX script that runs the IDL program aifeng.pro to read the 
database extraction Engineering file and create Launch-to-Date AIF Engineer- 
ing plots. See Appendix A, Figure A-9 "Launch-to-Date ENG Plot Produced as 
Part of Weekly Processing". 

• Runs dbwf, a UNIX script that runs the IDL program wfdiff.pro to read the 
database extraction Waveform files and create Launch-to-Date AIF Waveform 
Difference plots. See Appendix A, Figure A-10 "Launch-to-Date WF Difference 
Plot Produced as Part of Weekly Processing. 
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Section 6 

AIF Special Processing 

Special processing is defined as that processing which is not done on a regular chro- 
nological basis. Many dotelem products can be used for special processing along 
with commercial-off-the-shelf (COTS) software. Special processing can also be per- 
formed using IDL and Database Software. There are many other forms of special pro- 
cessing performed on TOPEX data; this section explains the general methods by 
which special processing is performed. 

6.1 dotelem Special Processing 

In general, ADF Special Processing is performed by using dotelem to create one or 
more special output files. The resulting files are then copied to a user for analysis or 
one of the TOPEX SWDT members uses custom IDL or COTS software to create the 
desired product. Any dotelem option can be used for special processing, but one of 
the more common ones is Waveform Averages. 

6.2 IDL Special Processing 

Another way to perform special processing is to create special IDL plot programs. 
This has been done on occasion to create special plots for papers and/or presenta- 
tions. Many of the standard IDL programs can also be run using non-standard argu- 
ments to produce plots according to custom specifications. 

6.3 Database Special Processing 

Custom database programs have been written to perform special processing. Some 
examples of these include routines to apply experimental temperature corrections, 
extract corresponding CAL and ENG data, and create other types of special output 
files. 

6.4 Examples of Special Processing 

Two examples of special processing include: (1) plotting AIF waveforms using both 
IDL and WingZ; and (2) plotting engineering data over the last 60 days. 

6.4.1 Plotting Waveforms 

To plot waveforms, dotelem is run to create averages of the data over a user-specified 
time interval. The resulting waveform average files are processed with topexwf (for 
fixed scales) or topexautowf (for automatic scales). This is the first-level waveform 
product. A sample waveform average plot is shown in Figure A-11 "Waveform Aver- 
age Plot Produced as Part of Special Processing". 

If a more detailed look is required, the waveform average file can be processed using 
the WingZ plot3d program on a Macintosh. The waveform average file is copied to 
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the Macintosh hard disk and transformed into a WingZ file. The program 
unix2wingz translates the waveform average file into the correct format. WingZ is 
launched and the plotSd script opened. The waveform wingz file is opened and the 
header row and columns B through M of the spreadsheet deleted. Finally, the plot3d 
script is run. The rest of the processing is interactive using the controls shown in Fig- 
ure 6-1 "WingZ plot3d Interface". 

6.4.2 Plotting Last 60 Days of ENG Data 

To plot the last 60 days of engineering parameters, data must be extracted from the 
AIF Engineering Database. The user would mn the database program and extract 
engineering data, selecting the range of dates he wishes to extract. See Figure 6-2 
"Database Extraction Screen" for a picture of the data extraction screen. Once the data 
are extracted, the database extraction file is copied to the Sun, and the IDL aifeng 
program is run to create the desired plots. 
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Section 7 

Components of AIF Processing 

Figure 7-1 depicts the flow of AIF data during processing. There are four major com- 
ponents of AIF processing software: dotelem, the FORTRAN which performs initial 
data processing; AIF databases, which handle data storage, retrieval, and secondary 
processing; IDL programs, which handle most of the plotting duties; and UNIX 
scripts, which automate much of the processing. These components comprise a sys- 
tem that is sufficiently automated to handle standard processing tasks and yet flexi- 
ble enough to assist in highly-detailed engineering assessment investigations. 



Figure 7-1 AIF Processing Dataflow 


I 
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7.1 dotelem 

dotelem is the FORTRAN program responsible for all AIF data processing. It is 
highly interactive, allowing the user to choose what process to run and to specify cus- 
tomized parameters for the chosen process. .Figure 7-2 "dotelem Startup Screen" 



Figure 7-2 dotelem Startup Screen 

depicts the dotelem startup screen, dotelem has three main components: the Initial- 
ization Module, the User Input Module, and the Data Processing Loop. Figure 7-3 
"dotelem Main Processing" on page 7-3 diagrams the highest-level dotelem process- 
ing. 

The software currently runs on osb3, a Sun Microsystems SparcStation 10 UNIX 
workstation. However, since dotelem was originally coded on the Apple Macintosh 
platform, and then ported to the Sun environment, the code has been designed to be 
highly portable. 
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7.1.1 dotelem Initialization Module 

Upon startup, dotelem initializes several data structures needed to decode and pro- 
cess data. There are basically three types of data structures used: byte maps, con- 
stants tables, and look-up tables. Byte maps are used for easily referencing which 
bytes in the raw telemetry data correspond to which converted engineering units. 
Constants tables contain constants used by various processing routines and are ini- 
tialized by reading values from appropriate external files. Lookup tables are used for 
such things as integer to mnemonic conversion, memory maps, and labeling. 

Table 7-1 lists the data structures initialized by dotelem. 


Table 7-1 Data Structures Initialized by dotelem 


Structure 

Description 

TelemEngDef 

Byte map of data contained in the AIF engineering record. 

TelemSciDef 

Byte map of data contained in the AIF science record. 

TelemConstDef 

Constants table used by telemetry processing.; Read from Data- 
File. TelemDriver. 

SensorConstDef 

Constants table for SDR creation. Read from DataFile. Sensor- 
Driver. 

CMDTableDef 

ASCII codes for converting integer commands to mnemonics. 
Read from DataFile.CMD. 

EngLabel 

Table of labels for identifying engineering parameters. 

EALimitsDef 

Constants table for Engineering Assessment. Contains reference 
values for CAL and Waveform data, as well as other engineering 
assessment constants. Read from DataFile.EALimits. 

ROMMapDef 

Table of reference addresses and 32-bit hex dumps for determining 
that altimeter ROM has not been corrupted. Read from DataFile. 
ROMMap. 


7.1 .2 dotelem User Input 

. dotelem is designed to be highly interactive and offer the user a variety of process- 
ing options. The user must enter the UTC time of the file to process and must select a 
processing method; the processing selection screen is shown in Figure 7-4 "dotelem 
Primary User Input Screen" on page 7-5. The user may optionally set custom parame- 
ters such as averaging time, mode selection, and parameters to report. Defaults are 
provided in all cases. Table 7-2 "dotelem Processing Options" on page 7-5 lists pro- 
cessing types, options, and defaults. Time selection is available as an option for all 
processes. 

7.1.3 dotelem Processing Loop 

After a user has chosen what process(es) to run and what options to use, dotelem 
runs in a processing loop until either all data have been read from both science and 
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Figure 7-4 dotelem Primary User Input Screen 
Table 7-2 dotelem Processing Options 


Parameter 

Options 

Defaults 

STANDARD Processing (default 
process) 

None 

Create AIF Datgabases 
1 5 sec Sciences Avgs. 

5 min Engineering Avgs. 

Create AIF Databases 

None 

1 Hour Engineering Avgs. 
CAL Mode Processing 
Check Waveforms 
Check Commands 
Check Science 
Check Engineereing 

Dump Telemetry Data 

Dump What Data 
Dump Full Rate 
Time Selection 

Science and Engineering 
No 

Process All Data 

Average Science Data 

Seconds to Average 
What Modes 
Time Selection 

60 Seconds ’ 
Track Modes 
Process All Data 

Average Engineering Data 

Seconds to Average 
What Modes 
Time Selection 

60 Seconds 
Track Modes 
Process All Data 
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Table 7-2 dotelem Processing Options (Continued) 


Parameter 

Options 

Defaults 

Average Waveform Data 

Seconds to Average 
What Modes 
Time Seletion 

60 Seconds 
Track Modes 
Process All Data 

Report Status Changes 

Check What Data 
Check What Params 
Time Selection 

S cience and Engineering 
All Parameters 
Process All Data 

QuickCAL 

None 

None 

Create SDR 

Debug Algorithms 

No 

Check Waveforms 

None 

None 


engineering files, or a time is detected that is later than a user-specified stop time, 
dotelem branches off the main loop to run those processes the user has specified. 

7.1.4 dotelem Time Synchronization 

Since AIF science and engineering data are sampled at different rates, the data must 
be time-synchronized during processing. The synchronization must take mto account 
such factors as the lack of science data during the IDLE mode, data dropouts, and 
corrupted records. Thus, it is important to validate the data used for time synchroni- 
zation so that a non-valid record has as little an impact as possible on the synchroni- 
zation routines. 

When processing is started, time synchronization is initialized by reading the first 
valid engineering and science frames. The engineering time is stored in both Eng- 
Time and NextEngTime, and the science time is stored in SciTime. The record pointer 
is then reset to the beginning of each file. 

SciTime, the time of the current science record, is compared to NextEngTime, the time 
of the next engineering record, to see if a new science record should be read. If there 
are more science data and SciTime is less than or equal to the NextEngTime, or there 
are no more engineering data, then a new valid science record is read. The time of the 
newly-read science record is stored into SciTime. 

NextEngTime is then compared with SciTime. If there are more engineering data, and 
NextEngTime is less than or equal to SciTime, or there are no more science data, then 
a new valid engineering record is read. The time of the newly read engineering 
record is stored into EngTime. The next valid engineering record is read and the 
pointer reset to the previous valid engineering record. The time of the next valid 
engineering record is stored into NextEngTime. 

The synchronization process is robust and does correctly synchronize science and 
engineering data. The key to the success of synchronization is the careful validation 
process through which newly-read AIF records must pass. Figure 7-5 "AIF Time Syn- 
chronization" details the AIF Time Synchronization Process. 
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Figure 7-5 AIFTime Synchronization 
7.1 .5 dotelem Record Validation 

AIF Science and Engineering data must be time-synchronized; it is critical that 
records are carefully checked during the data-input process. Since AIF data are 
assumed to be time-ordered, a corrupt time may cause the synchronization process to 
delete a great deal of valid data in the attempt to synchronize with an invalid time, 
dotelem performs extensive checking to ensure the validity of AIF records. There are 
three levels of error-checking performed. If the record passes all three levels, it is 
assumed to contain valid data. 
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The first level of error-checking uses the appropriate T4108 Preliminary Flags algo- 
rithm to check the Science or Engineering Frame Checksum. T4108 sets FlgEC4108 if 
it detects a bad checksum in the engineering record and sets FlgSC4108 if it detects a 
bad checksum in the science record. T4108 also sets FlgER4108 if it detects a reset. If 
any of these flags are set, the appropriate record is considered non-valid and is 
deleted. 

The second level of error-checking examines the contents of the AIF record header. 
The important fields in the header are the Continuity Map and Data Quality Map. 
The Continuity Map field verifies the presence of each major and minor frame neces- 
sary to complete the record. The Data Quality Map field verifies the checksum of 
each major and minor frame necessary to complete the record. If any Continuity or 
Data Quality flags are set, the record is considered non-valid and is deleted. 

The third and final level of error-checking tests the science or engineering Sync Byte. 
This step was necessary because a record containing all zeros would checksum cor- 
rectly, but would not be valid for use in processing. If the Sync Byte does not match 
the appropriate science or engineering reference value, the record is considered non- 
valid and is discarded. 

If an AIF record passes all tests, it is considered valid for use in time synchronization 
and further processing. The AIF Record Validation process is time-tested and has 
been proven to prevent non-valid data from being used during further processing. 
Furthermore, it has also been proven to delete only non-valid records. Figure 7-6 pro- 
vides a diagram of how this process works. 
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Figure 7-6 AIF Record Validation 


October 1998 


Page 7-9 


Version 2 






WFF TOPEX Software Documentation AIF Processing 


Components of AIF Processing 


7.1.6 dotelem Science Unit Conversion 

AIF Science data must be converted from raw telemetry data into engineering units 
to be used during processing. The process that performs this conversion is scieuconv. 
Algorithm T3117 Science Data EU Conversion is used for most of the conversion.. 
However, some additional parameters need to be decoded for further AIF processing; 
Table 7-3 "Other Converted AIF Science Parameters" on page 7-11 lists the parameters 
that are needed, but not decoded by T3117. 

7.1.7 dotelem Engineering Unit Conversion 

AIF Engineering data must be converted from raw telemetry data into engineering 
units to be used during processing. The process that performs this conversion is 
engeuconv. Algorithm T3107 Engineering Data EU Conversion is used for most of 
the conversion. However, some parameters not included in T3107 need to be decoded 
for further AIF processing. Figure 7-4 "dotelem Primary User Input Screen" on page 
7-5 lists the parameters that are needed, but not decoded by T3107. 

7.1.8 dotelem Standard Processing 

Standard Processing is the default process for dotelem. Standard Processing calls 
several of the other processing modules with specific parameters. Table 7-5 "Standard 
Processing Modules & Parameters" on page 7-12 lists the modules called and corre- 
sponding parameters supplied. See Appendix C for output file formats. 
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Other Converted AIF Science Parameters 


Description 

Converted into appropriate text mnemonic by table lookup using Dta- 
File.CMD. Other parameters converted include command type, status, 
and command count (if appropriate). 

Converted into integer representation. 

Converted into Ku and C band integer representations. Further decoded 
into Cal Mode Step. 

Converted into integer representation. 

Converted into integer representation. 


Converted into Integer representation. 
Converted Into integer representation. 


Other Converted AIF Science Parameters 


Description 


Converted into appropriate text mnemonic by table lookup using Dta- 
File.CMD. Other parameters converted include command type, status, 
and command count (if appropriate). 

Converted into integer representation. 

Converted into Ku and C band integer representations. Further decoded 
into Cal Mode Step. 

Converted into integer representation. 

Converted Into Integer representation. 


Converted into integer representation. 
Converted into integer representation. 
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Table 7-5 Standard Processing Modules & Parameters 


Module 

Parameters 

Average Science 

15 Second Averages, Track Modes Only 

Average Engineering 

5 Minute Averages, All Modes 

Average Engineering 

1 Hour Averages, All Modes 

Average Call Waveforms 

Average by step, Call Mode Only 

Check Status 

Check Science & Engineering, Check Standard Parameters 

QuickCAL 

- no options available- 

Check Waveforms 

* no options available- 


7.1.9 dotelem Create AIF Databases 

Create AIF Databases calls several of the other processing modules with specific 
parameters. Table 7-6 lists the modules called and corresponding parameters sup- 
plied. See Appendix C for output file contents and formats. 


Table 7-6 Create AIF Databases Modules & Parameters 


Module 

Parameters 

Average Engineering 

1 Hour Averages, All Modes 

Check Status 

Check Science & Engineering, Check Standard Parameters 

QuickCAL 

- no options available- 

Check Waveforms 

- no options available- 


7.1.10 dotelem Dump Telemetry 

The telemetry dumping routine, dumptelem, simply dumps all decoded parameters 
in each science and/or engineering record to output files. The user may specify if all 
data are to be dumped or just the first entry of each parameter array. See Appendix C 
for output file contents and formats. 

7.1 .1 1 dotelem: Average Science Data 

The science data averaging routine, sciavg, nms on a record-to-record basis and per- 
forms two similar but distinct functions; the creation of science averages files and the 
creation of daily science plot files. The basic algorithm is the same for both processes, 
but the creation of daily science plot files requires special handling to insure that land 
data are not used during computations. Processing the AIF science data are compli- 
cated by the lack of latitude /longitude and land /water flags. This deficiency reduces 
the usefulness of AIF science data and eliminates the requirement for WFF to keep 
AIF science databases. 

The sciavg processing begins with checking the mode of the current science record. 
The worse mode of the two modes is assigned to the variable WorseMode. This vari- 
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able is checked against the modes that the user has selected for processing. If Worse- 
Mode is not one of the user-selected modes, the record is marked as bad by setting 
the variable GoodRec to FALSE. 

A special-case routine for checking the modes of the current science record against 
previous modes is performed for the creation of daily science plot files. The purpose 
of this routine is to use only the best data in the averaging interval. This is done by 
comparing the better mode of the current record with the best mode yet seen in the 
interval. If the better mode of the current record is worse than the best mode yet seen, 
then the record is marked as bad by setting the variable GoodRec to FALSE. If the 
better mode of the current record is better than the best mode yet seen, the statistics 
for the interval are cleared and processing continues. Figure 7-7 "AIF Mode Compar- 
ison" shows the order by which modes are compared. 


Best ►Worst 


FTRK 


FACQ 


CTRK 


CACQ 


CALI 


CAL2 


STBY 


Figure 7-7 AIF Mode Comparison 

If a record is not a GoodRec, and there are no data in the current averaging interval, 
the module returns. Otherwise, elapsed time is checked to see if it exceeds the user- 
specified averaging interval. If so, the WriteData flag is set. Other conditions which 
would set the WriteData flag include a CAL step change, an End-of-File condition, or 
a difference between the worst mode of the averaging interval and the worst mode of 
the current record. 

If the WriteData flag has been set, averages are computed for the current interval. 
RMS statistics are also computed using the Hayne method (see memo in Appendix F> 
of scaling the RMS of the height differences to compute Ku and C-band RMS. The 
UseFlag parameter is set to false if any of the following conditions are true: 

• If the worst mode of the inter\'^al is not FTRK. 

• the number of records used in the interval is less that one-half the total num- 
ber of records in the averaging interval. 

• the number of T1016 Data Quality Flags (FlgAGC1016Ku and FlgAGC1016C 
and FlgSWH1016Ku and HgSWHlOieC and FlgHgtl016C and 
FlgHgtl016Ku and FlgHgtRatel016) is greater than zero. 

• the number of T5110 Waveform Flags (FlgHiSllO and FlgLoSllO) is greater 
than zero. 

If the GoodRec flag is set to FALSE, the process returns. Otherwise, several parame- 
ters of interest are computed using WFF Algorithms T1068 and T1016. A number of 
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flags returned by these algorithnas are checked and counters are incremented if cer- 
tain flags are set. 

A special case check of T1016 Data Quality flags (FlgAGC1016Ku and FlgAGC1016C 
and FlgSWH1016Ku and FlgSWH1016C and FlgHgtl016C and FlgHgtl016Ku and 
FlgHgtRatel016) is performed for the creation of daily science plot files. If any one of 
these flags is set, the GoodRec flag is set to FALSE and the process returns. 

Next, values of the primary science parameters are added to the statistics for the cur- 
rent interval, and WFF Algorithms T5110, T5135, and S5134 are run to compute sev- 
eral parameters of interest. Several flags generated by these algorithms are also 
checked and counted. At this point, sciavg is complete and returns. See Figure 7-8 
"AIF sciavg Processing" for a processing overview. See Appendix C for output file 
contents and formats. 



7.1.12 dotelem: Average Engineering Data 

The engineering data averaging routine, engavg, runs on a record-to-record basis and 
creates engineering average and database files. The module produces output records 
of the full-rate minimum, full-rate maximum, and interval average of engineering 
parameters. 

The engavg processing begins with checking the mode of the current engineering 
record. The mode is checked against the modes that the user has selected for process- 
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ing. If the mode is not one of the user-selected modes, the record is marked as bad by 
setting the variable GoodRec to FALSE. 

If this record is not a GoodRec, and there are no data in the current averaging inter- 
val, the module returns. Otherwise, elapsed time is checked to see if it exceeds the 
user-specified averaging interval; if so, the WriteData flag is set. Other conditions 
which would set the WriteData flag include an End-of-File condition, or a mode 
change to /from CAL or IDLE. 

If the WriteData flag has been set, averages are computed for the current interval and 
data are then written to the output file. 

If the GoodRec flag is set to FALSE, the process returns. Otherwise, the values of the 
primary engineering parameters are accumulated. Full-rate minimum and maximum 
values are checked and saved if necessary. At this point, engavg is complete and 
returns. See Figure 7-9 "AIF engavg Processing" for a processing overview. See 
Appendix C for output file contents and formats. 



7.1 .1 3 dotelem Waveform Averaging 

The waveform averaging routine, wfavg, runs on a record-to-record basis and creates 
high and low rate waveform average files. 

The wfavg processing begins with checking the mode of the current science record. 
The mode is checked against the modes that the user has selected for processing. If 
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the mode is not one of the user-selected modes, the record is marked as bad by set- 
ting the variable GoodRec to FALSE. 

If this record is not a GoodRec, and there are no data in the current averaging inter- 
val, the module returns. Otherwise, elapsed time is checked to see if it exceeds the 
user-specified averaging interval. If so, the WriteData flag is set. Other conditions 
which would set the WriteData flag include an End-of-File condition, a CAL step 
change, or a mode change. 

If the WriteData flag has been set, averages are computed for the current interval and 
data are then written to the output files. 

If the GoodRec flag is set to FALSE, the process returns. Otherwise, the values of the 
standard waveform parameters are accumulated. At this point, wfavg is complete 
and returns. See Figure 7-10 "AIF wfavg Processing" for a processing overview. See 
Appendix C for output file contents and formats. 



Figure 7-10 AIF wfavg Processing 


7.1 .1 4 dotelem Report Status Changes 

The Report Status Changes routines, scistatus and engstatus, check for record-to- 
record differences in user-specified parameters and optionally compares memory 
dumps to DataFile.ROMMap, the reference memory map. Table 7-7 "Parameters 
Checked by Report Status Changes Options" on page 7-17 lists the parameters 
checked for each user-specified option. 
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Table 7-7 Parameters Checked by Report Status Changes Options 


Option 

Source 

Parameters Checked 

All Parameters 

Science 

Status, Flags, Times, Commands, Memory, 

All Parameters 

Engineering 

Status, Flags, Times, Commands, Memory, 

Status Bytes 

Science 

CALAttenKu, CALAttenC, Synch ModeByte, 
ModeChangeByte, CurrModeByte, TestMode- 
Byte, OperModeByte, LimitByte, Mode, Track, 
AGCType, KuOn, COn, AltOper, WFFreqHi, 
WFFreqLo 

Status Bytes 

Engineering 

EngMode, BiLevels, EngAltOper 

Times 

Science 

Elapsed clock time, elapsed UTC time 

Times 

Engineering 

! 

Elapsed clock time, elapsed UTC time. Last Reset 
time. 

Commands 

Science 

LastICACMD, LastATACMD 

Commands 

Engineering 

LastCMDType, LastCMD, LastCMDStatus 

Memory 

Engineering 

MemDumpAddr, MemDump, EngMemChkSum, 
Compare Memory 

Database 

Science 

Times, Commands, KuOn, COn, AltOper, 
WFFreqHi, WFFreqLo 

Database 

Engineering 

Times, Commands, Compare Memory, Mem- 
DumpAddr, EngMemChkSum, BiLevels 

(Boldface parameters signify a group of individual parameters) 


7.1.15 dotelem calavg 

The CAL mode processing routine, calavg, runs on a record-to-record basis and cre- 
ates CAL average and database files. Reference CAL values are subtracted from the 
averages to compute deltas, calavg skips data at the beginning of each CAL mode 
and each CALI step to allow for settling, and temperature-corrects AGC data. 

The calavg processing begins by checking the mode of the current science record. If 
the mode is not one of the CAL modes, the record is marked as bad by setting the 
variable GoodRec to FALSE. 

If this record is not a GoodRec, and there are no data in the current averaging inter- 
val, the module returns. Otherwise, elapsed time is checked to see if it exceeds the 
user-specified averaging interval, or more likely, if the CAL mode or Step has 
changed. If so, the WriteData flag is set. 

If the WriteData flag has been set, averages are computed for the current interval and 
references subtracted from the averages. Data are then written to the output file. See 
Appendix D for the current CAL mode references. 
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If the GoodRec flag is set to FALSE, the process returns. Otherwise, at the start of 
CALI or a Step change, one CAL record is skipped. At the start of CAL2, 9 records 
are skipped. If enough records have not been skipped, the process returns. 

If sufficient records have been skipped, CALI AGC is CAL- Attenuator temperature- 
corrected and the values of the CAL parameters are accumulated. At this point, 
calavg is complete and returns. See Figure 7-11 "AIF calavg Processing" for a process- 
ing overview. See Appendix C for output file contents and formats. 



Figure 7-11 AIF calavg Processing 

7.1 .1 6 dotelem Create SDR 

createsdr, the SDR creation routine, uses WFF Algorithms and some WFF-coded JPL 
Algorithms to create a pseudo-SDR. This is primarily used for algorithm testing and 
debugging purposes and is not an attempt to create an exact replica of an "official" 
JPL SDR. Table 7-8 "Algorithms Used in createsdr" on page 7-19 lists the algorithms 
used in the SDR creation process. 

7.1.17 dotelem Check Waveforms 

checkwf, the waveform checking routine, is used to determine if waveform shapes in 
CAL2 and STBY modes are changing. It does this by averaging waveforms in CAL2 
and STBY, and subtracting a reference waveform from each average. The resulting 
deltas are then checked to see if there are values that exceed pre-set limits. 
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Table 7-8 Algorithms Used in createsdr 


Algorithm 

Developer 

Implementation Notes 

T4108 

WFF 

Complete Implementation. 

T3107 

WFF 

Complete Implementation. 

T3117 

WFF 

Complete Implementation. 

T4109 

JPL 

Uses only WFF-Generated Variables. 

T1068 

WFF 

Complete Implementation. 

T1016 

WFF 

Complete Implementation. 

T5110 

WFF 

Complete Implementation. 

T5135 

WFF 

Complete Implementation. 

T1165 

WFF 

Complete Implementation. 

T1145 

WFF 

Complete Implementation. 

T1155 

WFF 

Complete Implementation. 


The checkwf processing begins by checking the mode of the current science record. If 
the mode is not CAL2 or STBY, the record is marked as bad by setting the variable 
GoodRec to FALSE. 


If this record is not a GoodRec, and there are no data in the current averaging inter- 
val, the module returns. Otherwise, if the mode has changed, the WriteData flag is 
set. 

If the WriteData flag has been set, averages are computed for the current interval and 
references subtracted from the averages. The averages are checked against limits and 
alarm messages written if a limit is exceeded. Data are then written to the output file. 
See Appendix D for the current waveform reference and limits. 

If the GoodRec flag is set to FALSE, the process returns. Otherwise at the start of 
CAL2, 9 records are skipped. If enough records have not been skipped, the process 
returns. One waveform (waveform, not record) is skipped if the Mode is STBY. 

If sufficient records or waveforms have been skipped, the values of the waveform 
parameters are accumulated. If the mode is STBY, one-record averages are used. If 
the mode is CAL2, an average of the whole CAL2 interval is used. At this point, 
checkwf is complete and returns. See Appendix C for output file contents and for- 
mats. 

7.1.18 dotelem Average CALI Waveforms 

The CALI mode waveform averaging routine, calwfmon, runs on a record-to-record 
basis and creates CALI high and low rate waveform averages files. Calwfmon skips 
data at the beginning of each CALI step to allow for settling, and temperature-cor- 
rects AGC data. 
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The calwfmon processing begins by checking the mode of the current science record. 
If the mode is not one of the CAL modes, the record is marked as bad by setting the 
variable GoodRec to FALSE. 

If this record is not a GoodRec, and there are no data in the current averaging inter- 
val, the module returns. Otherwise, elapsed time is checked to see if it exceeds the 
user-specified averaging interval, or more likely, if the CAL mode or Step has 
changed. If so, the WriteData flag is set, and averages are computed for the current 
interval. 

If the GoodRec flag is set to FALSE, the process returns. Otherwise, at the start of 
CALI or a Step change, one CAL record is skipped. 

If sufficient records have been skipped, CALI AGC is CAL- Attenuator temperature- 
corrected and the values of the CAL parameters are accumulated. At this point, calw- 
fmon is complete and returns. See Figure 7-12 "Call Waveform Averaging" for a pro- 
cessing overview. See Appendix C for output file contents and formats. 



7.2 AIF Databases 

FoxBase/Mac is used as the TOPEX AIF Database management system. The database 
Main Menu is depicted in Figure 7-13 "TOPEX AIF Database Main Menu" on page 7- 
21. Using this system, AIF data can be imported, exported, sorted, and searched. Spe- 
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Figure 7-13 TOPEX AIF Database Main Menu 


cial-purpose programs can be created to perform specific processing on the AIF data 
prior to exporting. Database structures are documented in Appendix C . 

7.2.1 AIF Databases Append Data 

Files created by the dotelem database processing routines are imported into and 
appended to the AIF databases. The Append Menu is shown in Figure 7-14 "AIF 
Database Append Menu" on page 7-22. Due to standard naming conventions, the 
user is prompted to pick one of the five import files. The database program then com- 
putes the other four filenames and checks for the existence of those files. If any of the 
five files are missing or misnamed, the import process is canceled. If all files exist, 
then the program imports the data from each file into the appropriate database. Table 
7-9 "AIF Database Import Files" on page 7-22 lists the files required to import data. 

7.2.2 AIF Databases Export Data 

The AIF database system allows a user to extract data according to specified criteria. 
There are currently three extraction files available: Waveforms, CAL, and Engineer- 
ing. The user may select from a range of dates and specific conditions to restrict the 
data extraction. The extraction files are written in the same format as the correspond- 
ing databases. See Appendix C for the database export file formats. 
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the i^itg one of the three detebe&e output fllee created 
by the detsbase precesai ny program. Filenames are expected to be 
consistent and adhere to the follovi ng format : 


Ifeader 


eg: 

«if.Mr_001_001 Ab 

QK 

Mr.dbase 

CAL 

*cal* 

eg: 

*if_cal^001_001 .db 

OR 

oal.dbase 

£ruglii : 

♦eng*' 

eg: 

4il_e»g_00l_001 .db 

OR 

exkig.dbsse 

17avef orm : 


eg: 

,db 

OR 

R'il.dbsse 


Given one filename and this format, the Append routine vnll create 
the other filenames from the one selected. 


Oonii 


Figure 7-14 AIF Database Append Menu 


Table 7-9 AIF Database Import Files 


Std. Filename 

Database 

Description 

cal.dbase 

cal 

Concatenated files of dotelem cal output. 

hdr. dbase 

header 

Concatenated files of dotelem headers output. 

eng. dbase 

engin 

Concatenated files of dotelem 1-hour engineering output 



Concatenated files of dotelem high rate checkwf output. 

wfl.dbase 

wflo 

Concatenated files of dotelem low rate checkwf output. 



7.2.3 AIF Call Waveform Database 

Files created by the dotelem standard processing routines are appended to the AIF 
Call waveform database. See table for file content and format.Table C-11 "AIF Cal 
Waveform Monitor Database" Table 7-10 "AIF Cal Waveform Monitor Database Files" 
lists the files required to import data. 


Table 7-1 0 AIF Cal Waveform Monitor Database Files 


Std. Filename 

. 

Database 

Description 

calwfmonhi.dbase 

calwfmonhi 

Concatenated files of dotelem high rate Call wf output. 

calwfmonlo.dbase 

calwfmonlo 

Concatenated files of dotelem low rate Call wf output. 
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7.3 AIF IDL Software 

IDL, Interactive Data Language, is a software package written by Research Systems, 
Inc. It is an array-based scientific visualization package that enables a programmer to 
quickly and easily write code to generate highly customized plots and analyses. IDL 
has allowed the TOPEX SWDT to automatically generate products that were difficult 
and time-consuming to produce using COTS software. 

TOPEX IDL programs generally can read dotelem average files or database export 
files and produce standardized plots on a PostScript printer. These programs are 
coded with a set of parameters which may be modified to customize features of the 
final output without changing the IDL code. Table 7-11 "IDL Parameters" lists the 
standard parameters that may be modified by the user. Appendix B lists the UNIX 
scripts which run TOPEX IDL programs. 


Table 7-1 1 IDL Parameters 


Parameter 

Default 

Description 

InputFile 

n/a 

Text file from which data to be processed is read. 

XPIots 

varies 

Number of plots stacked horizontally per page. 

YPIots 

varies 

Number of plots stacked vertically per page. 

Printer 

topex2 

Printer where output will be printed. 

AutoScale 

FALSE 

Switch to automatically set axis scales by min & max of 
data, rather than by standard scale values. 

Landscape 

varies 

Switch to print in landscape rather than portrait mode. 

DeviceType 

'ps' 

Type of device driver to use (ps=PostScript). 

PlotTitle 

InputFile 

Title to place on plot. May be overridden by program. 

Color 

TRUE 

Switch to define that color should be used for output. 

Scale 1 

1.0 

Factor by which to scale whole page. Useful for incorporat- 
ing output in presentations or publications. 

Manual 

FALSE 

Switch to define that printer should be set to Manual Feed 
mode. Highly printer-dependent. 

All 

FALSE 

Switch to define that all output products should be printed 
rather than the standard subset. Used by only some pro- 
grams. 

SinceLast 

TRUE 

Switch to define that output data should be subsetted by a 
pre-defined interval. Useful for restricting Launch-to-Date 
output. 


7.4 UNIX Scripts 

UNIX scripts are used to automate common tasks and supply standard parameters to 
TOPEX AIF software. Some shell scripts are invoked by the crontab facility to per- 
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form daily processing. Other shell scripts are used for automatically retrieving and 
processing special data from JPL, automatically running IDL programs, and miscella- 
neous utility functions. Appendix B contains a list of UNIX scripts which are avail- 
able for use. 
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Appendix A 

Standard Products 


This appendix contains samples of the standard products produced by the TOPEX 
AIF software. A note is made, where appropriate, detailing the frequency of produc- 
tion of the product. 


csh /gen/tqpex2/bin/autoaif 
produced the following output: 

Tue May 3 03:00:11 EDT 1994 -- starting JPL automatic copying., 
wf f dev : [wffiiser.wff_data] tcc_alteng_1994122t000000.bin copied. Retrys : 1 
wff dev : [wf fuser .wff^data] tcc__altsci_1994122t 000000 .bin copied. Retrys : 1 
wf f dev : [wffuser.wff_dataltcc_wffl_1994122t000000.bin copied. Retrys : 1 

Tue May 3 03:44:59 EDT 1994 -- running doteletn. . . 

Tue May 3 03:59:01 EDT 1994 -- moving tcc_wffl_1994122t000000.bin to /gen/ f light /aif 

Tue May 3 03:59:04 EDT 1994 -- Printing IDL Hdr Page... 

Tue May 3 03:59:18 EDT 1994 -- Printing IDL CAL plots.. . 

Tue May 3 03:59:21 EDT 1994 -- Printing IDL Science plots... 

Tue May 3 04:00:01 EDT 1994 - - Printing IDL Engineering plots . . . 

Tue May 3 04:00:13 EDT 1994 -- Printing IDL Waveform plots... 

Tue May 3 04:00:20 EDT 1994 -- Printing events... 

request id is topex-115 (1 file(s)) 

Tue May 3 04:01:29 EDT 1994 -- Automatic Processing Coirplete. 

-- See jplauto_1994122t000000.log for more details. -- 


Figure A-1 AIF Processing Log Produced as Part of Daily Processing 


October 1 998 


Page A-1 


Version 2 



WFF TOPEX Software Documentation AIF Processing 


Standard Products 


TOPEX Daily AIF Summary Information 


Header ID: 

Day Number: 

Alt: 

KuOn: 

COn: 

Date Processed: 

WFF Program: 

WFF Version: 
TelemConst Version: 
EALimits Version: 
ROMMap Version: 

Bad Eng Records: 

Bad Scl Records: 

Hours in TRACK: 

Scl Data Lost (sec): 

Eng Data Lost (sec): 
Last RST, # RSTs: 
STBYWF Alarms(Hi,Lo): 
CAL2WF Alarms(HI,Lo): 


0 

1994121 

A 

ON 

C32 

05/02/94 

doTelem 

3.5,01/25/94 

13,05/11/93 

07,01/26/94 

1.3,12/08/93 

7 

27 

23.84 

26.8 

49.1 

31D99295124E,0 

3,0 

4,3 


Figure A-2 AIF Processing Summary Produced as Part of Daily Processing 
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5t*p(20*CAL2) 

aif_caLl99412f!000000.db : Delta AGCKu <dB): CALI 



Slap (20 - CAL2) 

aif_caL19941 21 tOOOOOO.dfa : Delta AGCC (dB): CALI 



Figure A-3 AIF CAL Plot Produced as Part of Dally Processing 
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Engineering MonKors Engineering Monitors Engineering Temperatures 




Hours, from -1 .78977440408 to -V7889134e+08 


Figure A-4 AIF Engineering Plot Produced as Part of Daily Processing 
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Figure A-7 AIF Events Report Produced as Part of Daily Processing 



1994121 -178977599.55 1994-121100:00:00 SCI Mode 

Mode(1,2) FTRK.FTRK 

1994121 -178977586.17 1994-121700:00:14 ENG dTIme Time_Last_Resel 53525914.95 
1994121 -178977586.17 1994-121700:00:14 ENG d7ime 7ime_Last_Reset_Hex 31D99295124E 

1994121 -178977553.40 1994-121700:00:47 ENG Status 

BadEngRecs 1 

1994121 -178977539.52 1994-121700:01:00 SCI Status 
1994121 -178977539.52 1994-121700:01:00 SCI d7lme 
1994121 -178977539.52 1994-121700:01 :00 SCI d7ime 

BadScIRecs 1 

ScLTime_SDF 2.15 

ScLTime^UTC 2.1 1 

1994121 -178977537.02 1994-121700:01:03 ENG d7ime 
1994121 -178977537.02 1994-121700:01:03 ENG d7ime 

Eng_Time_EDF 17.16 

Eng^Time.UTC 16.38 

1994121 -178972859.39 1994-121701:19:01 ENG CMD Last_Command(1) ICA AWENBLK1 OK 

1994121 -178972859.39 1994-121701:19:01 ENG CMD Last_Command(4) A7As S7ANDBY OK 

1994121 -178972859.39 1994-121701:19:01 ENG CMD Last_Command(5) A7As CAL OK 

1994121 -178972859.39 1994-121701:19:01 ENG CMD UsUCommand(7) ICA AFULLON OK 

1994121 -178972859.39 1994-121701:19:01 ENG Memory ENG_Memory_CheckSum BDD5 

1994121 -178972855.80 1994-121701:19:04 SCI Mode 

Mode(1.2)STBY.STBY 

1994121 -178972854.78 1994-121701:19:05 SCI Mode 

Mode(1,2) CALI, CALI 

1994121 -178972851.20 1994-121701:19:09 ENG Memory 

ENG_Memory_CheckSum 5CE9 

1994121 -178972678.08 1994-121701:22:02 SCI Mode 

Mode{1,2) CAL2,CAL2 

1994121 -178972613.63 1994-121701:23:06 ENG CMD 
1994121 -178972613.63 1994-121701:23:06 ENG CMD 
1994121 -178972613.63 1994-121701:23:06 ENG CMD 
1994121 -178972613.63 1994-121701:23:06 ENG CMD 
1994121 -178972613.63 1994-121701:23:06 ENG Memory 

Last_Command(1)ICA AWENBLK1 OK 
Last_Command(4) ATAs STANDBY OK 
Last_Command(6) ATAs TRACK OK 
Last_Command(7) ICA AFUaON OK 
ENG_Memory_CheckSum 5CF5 

1994121 -178972610.94 1994-121701:23:09 SCI Mode Mode(1,2) S7BY,S7BY 

1994121 -178972640.37 1994-121701:22:40 WF CAL2LO Gate 44 Upper 0.7 0.99 
1994121 -178972640.37 1994-121701:22:40 WF CAL2LO Gate 48 Upper 0.5 0.58 

1994121 -178972608.83 1994-121701:23:11 SCI Mode 

Mode(1,2) CACQ.CACQ 

1994121 -178948750.33 1994-121708:00:50 ENG Status 

BadEngRecs 1 

1994121 -178948739.83 1994-121708:01:00 SCI Status 
1994121 -178948739.83 1994-121708:01 :00 SCI d7ime 
1994121 -178948739.83 1994-121708:01 :00 SCI d7lme 

BadSciRecs 1 

ScLTime.SDF 2.17 

Sci_7ime_UTC 2.18 

1994121 -178948733.95 1994-121108:01:06 ENG dTime 
1994121 -178948733.95 1994-121108:01:06 ENG dTime 

Eng_Tlme_EDF 16.27 

Eng_Time.UTC 16.38 

1994121 -178937723.90 1994-121711:04:36 ENG Status 

BadEngRecs 1 

1994121 -178937707.64 1994-121711:04:52 SCI Status 
1994121 -178937707.64 1994-121711:04:52 SCI d7ime 
1994121 -178937707.64 1994-121711:04:52 SCI dTime 

BadSciRecs 1 

Sci_Time„SDF 2.15 

ScLTime.UTC 2.18 

1994121 -178937707.51 1994-121711:04:52 ENG dTime 
1994121 -178937707.51 1994-121711:04:52 ENG dTime 

Eng_Time_EDF 16.12 

Eng_Tlme_UTC 16.38 
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Figure A-7 AIF Events Report Produced as Part of Daily Processing (Continued) 


1994121 -178933562.36 1 994-121112:13:58 ENG CMD Last_Command(4) (CA AWENBLK1 OK 

1994121 -178933562.36 1994-121X12:13:58 ENG CMD Last_Command(6) ATAs STANDBY OK 

1994121 -178933562.36 1994-121X12:13:58 ENG CMD Last_Command(8) AXAs CAL OK 

1994121 -178933562.36 1994-121X12:13:58 ENG Memory ENG_Memory_CheckSum BDD5 


1994121 -178933556.67 1994-121X12:14:03 SCI Mode Mode(1,2) SXBY.SXBY 
1994121 -178933556.67 1994-121X12:14:03 WF SXBYHI Gate 84 Upper 10.0 13.22 
1994121 -178933555.64 1994-121X12:14:04 WF SXBYHI Gate 64 Upper 5.0 7.21 


1994121 -178933554.62 1994-121X12:14:05 SCI Mode 


Mode(1.2) CALI, CALI 


1994121 -178933554.17 1994-121X12:14:06 ENG CMD Last_Command{2) ICA AFULLON OK 
1994121 -178933554.17 1994-121X12:14:06 ENG Memory ENG_Memory_CheckSum 5CE9 


1994121 -178933377.98 1994-121X12:17:02 SCI Mode 


Mode(1,2) CAL2.CAL2 


1994121 -178933316.60 1994-121X12:18:03 ENG CMD Last^Command(4) ICA AWENBLK1 OK 
1994121 -178933316.60 1994-121X12:18:03 ENG CMD Last_Command(7) AXAs STANDBY OK 
1994121 -178933316.60 1994-121X12:18:03 ENG Memory ENG_Memory_CheckSum BDD5 


1994121 -178933310.78 1994-121X12:18:09 SCI Mode Mode(1, 2) SXBY.SXBY 

1994121 -178933340.24 1994-121X12:17:40 WF CAL2H1 Gate 17 Upper 0.4 0.46 

1994121 -178933340.24 1994-121X12:17:40WF CAL2LOGate 44 Upper 0.7 0.75 

1994121 -178933340.24 1994-121X12:17:40 WF CAL2HI Gate 49 Upper 0.3 0.35 

1994121 -178933340.24 1994-121X12:17:40 WF CAL2HI Gate 59 Upper 0.3 0.37 

1994121 -178933340.24 1994-121X12:17:40 WF CAL2HI Gate 85 Upper 0.3 0.43 

1994121 -178933310.78 1994-121X12:18:09 WF SXBYHI Gate 39 Lower -35.0 -35.18 


1994121 -178933308.73 1994-121X12:18:11 SCI Mode Mode(1,2) CACQ.CACQ 


1994121 -178933308.41 1994-121X12:18:12 ENG CMD LasUCommand(l) AXAs TRACK OK 
1994121 -178933308.41 1994-121X12:18:12 ENG CMD LasLCommand(2) ATAs $ C00F7B OK 
1994121 -178933308.41 1994-121X12:18:12 ENG CMD Last_Command(3) ICA AFULLON OK 
1994121 -178933308.41 1994-121X12:18:12 ENG Memory ENG_Memory_CheckSum 5CF5 


1994121 -178931809.27 1 994-121X12:43:11 ENG Status 

1994121 -178931793.34 1994-121X12:43:27 SCI Status 
1994121 -178931>93.34 1994-121X12:43:27 SCI dXime 
1994121 -178931793.34 1994-121X12:43:27 SCI dXime 


1994121 -178931792.89 1994-121X12:43:27 ENG dXime 
1994121 -178931792.89 1994-121X12:43:27 ENG dXime 


1994121 -178924770.81 1994-121X14:40:29 SCI Status 
1994121 -178924770.81 1994-121X14:40:29 SCI dXime 
1994121 -178924770.81 1994-121X14:40:29 SCI dXime 


1994121 -178924766.78 1994-121X14:40:33 SCI Status 
1994121 -178924766.78 1994-121X14:40:33 SCI dXime 
1994121 -178924766.78 1994-121X14:40:33 SCI dXime 

1994121 -178924759.67 1994-121X14:40:40 SCI Status 
1994121 -178924759.67 1994-121X14:40:40 SCI dXime 
1994121 -178924759.67 1 994-121X14:40:40 SCI dXime 


BadEngRecs 

BadSciRecs 

ScLXime_SDF 

Sci_Xime_UXC 


Eng_Xime_EDF 

Eng_Xime_UXC 

BadSciRecs 

ScLXime_SDF 

Sci_Xime_UXC 

BadSciRecs 

Sci_Time_SDF 

Sci_Xime_UXC 

BadSciRecs 
Sci_Xime_SDF 
Sci.Xime UXC 
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Figure A-7 AIF Events Report Produced as Part of Daily Processing (Continued) 


1994121 -178924758.71 1994-121T14:40:41 SCI dTIme 

Sci_Time_UTC 

0.96 

1994121 -178924755.64 1994-121114:40:44 SCI Status 

BadSciRecs 

2 

1994121 -178924755.64 1 994-121114:40:44 SCI dTime 

ScLTime^SDF 

3.23 

1994121 -178924755.64 1994-121114:40:44 SCI dTime 

ScLTime_UTC 

3.07 

1994121 -178919955.45 1994-121116:00:45 ENG Status 

BadEngRecs 

1 

1994121 -178919939.83 1994-121716:01:00 SCI Status 

BadSciRecs 

1 

1994121 -178919939.83 1994-121116:01:00 SCI dTime 

ScLTime^SDF 

2.15 

1994121 -178919939.83 1994-121716:01:00 SCI dTime 

ScL7ime_UTC 

2.18 

1994121 -178919939.07 1 994-121716:01:01 ENG dTime 

Eng_Time_EDF 

16.11 

1994121 -178919939.07 1994-121716:01:01 ENG dTime 

Eng_7ime_UTC 

16.38 

1994121 -178910755.83 1994-121718:34:04 ENG Status 

BadEngRecs 

1 

1994121 -178910747.13 1994-121718:34:13 SCI Status 

BadSciRecs 

1 

1994121 -178910747.13 1994-121718:34:13 SCI dTime 

Sci_Time_SDF 

2.15 

1994121 -17B910747.13 1994-121718:34:13 SCI dTime 

ScLTime_UTC 

2.11 

1994121 -178910739.45 1994-121718:34:2 

1994121 -178910739.45 1994-121718:34:21 ENG dTime Eng_Time.UTC 

16.38 

1994121 -178891209.72 1994-121723:59:50 ENG Status 

BadEngRecs 

1 

1994121 -178891200.38 1994-122700:00:00 SCI TOTAL 

BadSciRecs 

27 

1994121 -178891209.72 1994-121723:59:50 ENG TOTAL 

BadEngRecs 

7 
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Launch-to- Date. cal : Delta HgtC (mm): CAL1, Step 0 



Uom 1992239 10 1 994170 

Launch-to- Dale .cal : Delta HgtC (mm): CALl, Step l 


Days, from 1992239 to 1994170 

Lajnch-to-Date.cal : Delta HgtC (mm): CALI, Step 2 


Days, from 1902239 to 1994170 

Launch-to- Date. cal : Delta HgtC (mm): CALI, Step 3 


Days, from 1992239 to 1994170 


Figure A-8 Launch-to-Date CAL Plot Produced as Part of Weekly Processing (Continued) 
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Launch-to-Date CAL Plot Produced as Part of Weekly Processing (Continued) 
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Figure A-8 Launch-to-Date CAL Plot Produced as Part of Weekly Processing (Continued) 
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AIF ENG Database : LasISOOays.eng : Mode 
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Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing 
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AIF ENG Database : LasOODays.eng : Rec IQ Vid Seel {Deg C) 
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AIF ENG Dalabase : Last30Days.eng : C MTU IF Preamp (Oeg C) 
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Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing (Continued) 
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Days, from 1994155 lo 1994105 








AIF ENG Database : Lasl30Days.eng : Downconverter (Deg C) 
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Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing (Continued) 
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Days, from 1994IS5I0 1994185 







AIF ENG Database : Last30Days.eng : SP A/D Conv Amps (Deg C 
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Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing (Continued) 
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Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing (Continued) 


October 1 998 


Page A-27 


Version 2 






AIF ENG Oalabase : LastSOOays.eng : LVPS +28V (Volls) 
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Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing (Continued) 
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AIF ENG Database : Last30Days.eng 


Delta Ku Xmit Power (dB). CAL McxJe Only 


Days, trom 19941 55 to 1994185 



Days, trom 1994155 to 1994185 


Figure A-9 Launch-toDate ENG Plot Produced as Part of Weekly Processing (Continued) 
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Figure A-10 Launch-to-Date WF Difference Plot Produced as Part of Weekly Processing 
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AIF WF Database : Launch-to-Dale.hi : DeHa from Reference (%): STBY, Gate 38 
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Days, from 1992239 to 1994205 







AIF WF Database : Launch-to-Date.lo 
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Figure A-10 Launch*to-Date WF Difference Plot Produced as Part of Weekly Processing 
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Days, from 1992239to 1994205 




AIF WF Database : Launch-to-Date.lo : DeUalrom Relerence (%): STBY, Gale 30 
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calwfmonallhi 



Days, from 1992243 to 1998223 
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Appendix B 

Software Matrix 


Table B-1 AIF Software Matrix 


Software 

Data Source 

Products 

Description 

aifcal 

CAL (Avg or DB) 

Daily CAL Plot 
(Figure A-3) 

UNIX script that runs IDL aif- 
cal. pro. Creates Daily CAL plots. 

aifeng 

ENG (Avg or DB) 

ENG Plot 
(Special) 

UNIX script that runs IDL 
aifeng.pro. Creates special ENG 
plots displaying ALL parameters. 

aifhdr 

DB Header & Events 

Process Summary 
(Figure A-2) 

UNIX script that runs IDL aif- 
hdr.pro 

aifsci 

SCI Avg 

Science Plot 
(Figure A-5) , 

UNIX script that runs IDL aif- 
sci.pro 

alldbcal 

CAL DB 

CAL Plot 
(Special) 

UNIX script that runs IDL allaif- 
cal. pro. Creates special CAL 
plots displaying ALL steps. 

autoaif 

Current Date or User- 
Specified Date 

Daily Products 
(Figure A-1 through 
A-7) 

UNIX script automatically 
invoked by the crontab facility 
that performs all AIF daily pro- 



clkconvert 


dailyeng 


dailywf 


dbeng 


User Input 


ENG Avg 


WFDiff 



ENG DB 


Converted Time 
(Displayed Only) 


Daily ENG Plot 
(Figure A-4) 


Dally WFDiff Plot 
(Figure A-6) 


DB CAL Plot 
(Figure A-8) 


DB ENG Plot 


cessing. (FTP) 


Old version of autoaif that used 
DECNET to copy AIFs rather 
than FTP. 


FORTRAN program that con- 
verts hexadecimal spacecraft 
clock time into seconds. 


UNIX script that runs IDL daily- 
eng.pro. Creates Daily ENG 
plots. 


UNIX script that runs IDL 
wfdiff.pro. Creates Daily 
WFDIFF plots. 


UNIX script that runs IDL aif- 
cal.pro. Creates Launch-to-Date 
CAL plots. 


UNIX script that runs IDL 
aifeng.pro. Creates Launch-to- 
Date ENG Plots. 
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Table B*1 AIF Software Matrix (Continued) 


Software 


Data Source 


dotelem 


WF DB 


AIF SCI & ENG Files 


finishalf 


fittpxS 


launchtodate 


Current Date or User- 
Specified Date 


WF Avgs 


Launch-to-Date DBs 


Isjplaif 


mtopexautowf WF Avgs 


mtopexwf 


WF Avgs 


Current Date or User- 
Specified Date 


topexautowf WF Avgs 


Products 

DB WF Plot 
(Figure A-10) 

DB Header 
Events 

DB/QuickCAL 
DB/Avg ENG 
DB/Avg WFDiff 
Avg Waveforms 
Avg Science 
Science Dump 
ENG Dump 

Daily Products (Fig- 
ure A-1 through A-7) 


See Attached Memo 
GSH 7/21/93. 

Launch-to-Date 
Database Plots 
(Figures A-8 through 
A-11) 


List of AIF files (Dis- 
play Only) 


Modified WF Plots 
(Special) 


Modified WF Plots 
(Special) 


Daily Products 
(Figure A-1 through 
A-7) 


WF Plots 
(Figure A-11) 


Description 

UNIX script that runs IDL 
wfdiff.pro. Creates Launch-to- 
Date WFDIFF plots 

Main TOPEX WFF AIF process- 
ing program. Coded in FOR- 
TRAN. 


UNIX script that performs the 
same functions as autoaif, with 
the exception of copying the AIF 
files from JPL. 

See Attached Memo GSH 7/21/ 
93. 

UNIX script that runs IDL dbcal, 
dbeng, & dbwf. 


UNIX script that automatically 
runs an FTP session to list AIF 
files available at JPL. 


UNIX script that runs IDL 
mtopexautowf.pro. Creates 
autoscaled waveform plots mod- 
ified as requested by GSH. 


UNIX script that runs IDL 
mtopexwf.pro. Creates fix-scaled 
waveform plots modified as 
requested by GSH. 


UNIX script that performs the 
same functions as autoaif, with 
the exception of creating and 
concatenating database files. 
Useful for automatically process- 
ing special data from JPL. 


UNIX script that runs IDL 
mtopexwf.pro. Creates 
autoscaled waveform plots. 
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Table B-1 AIF Software Matrix (Continued) 


Software 

Data Source 

Products 

Description 

topexseu 

DataFile.SEU 

SEU Plot 
(Figure A- 13) 

UNIX script that runs IDL topex- 
seu. pro. Creates SEU plots. 

topexwf 

WF Avgs 

WF Plots 
(Special) 

UNIX script that runs IDL 
topexwf.pro. Creates fix-scaled 
waveform plots. 

wfdiff 

WF Diffs 

WFDiff Plots 
(Figure A-6) 

UNIX script that runs IDL 
wfdiff.pro. Creates WFDIFF 
plots. 

wfdiffall 

WF Diffs 

WFDiff Plots 
(Special) 

UNIX script that runs IDL 
wfdiff.pro. Creates WFDIFF plots 
with ALL steps. 


I 
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Appendix C 

File & Database Contents 


This appendix documents file and database formats used in AIF processing. By defi- 
nition, database files will be SPACE-delimited, while average files are TAB delimited. 




Table C-1 

AIF Header Database Format 

Field 

Fmt 

Units 

Description 



14 


17 


A1 


A3 


A3 


dateproc A9 


wffprg 


wffvers 


telemvers A15 


eavers 


romvers 


badeng 


badsci 


trackhrs 


scilost 


englost 


Year and Julian Day 


n/a Altimeter Operating (A/B) 


n/a Operating Status of Ku-Band (ON/OFF) 


n/a Operating Status of C-Band (C32/C1 0/OFF) 


n/a Date Data was Processed at WFF 


n/a WFF Software Used to Process Data 


n/a Version of WFF Software Used to Process Data 


n/a Version of DataFile.TelemDriver Used to Process Data 


n/a Version of DataFile.EALimits Used to Process Data 


n/a Version of DataFile.ROMMap Used to Process Data 


records Number of Bad Engineering Records Detected 


records Number of Bad Science Records Detected 


Hours Number of Track-Mode Hours 



I 
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Table C-2 AIF CAL Database/QuickCAL Format 


Field 

Fmt 

utcsec 

FI 3.2 

day 

17 

wffid 

12 

hdrid 

12 

step 

12 

mode 

A4 

numrec 

14 

deltahgtku 

F8.4 

deltahgtc 

F8.4 

deltaagcku 

F8.4 

deltaagcc 

F8.4 

useflag 

r LI 


Units Description 


seconds Average UTC Seconds 


YYYYDDD Year and Julian Day 


n/a Database Link 


n/a Database Link 


CAL Step (-16. 20 = CAL2) 


Mode (CAL1/CAL2) 


records Number of Records Used to Compute Averages 


Amm Computed Average HgtKu - Reference (TempCorr) 


Amm Computed Average HgtC - Reference (TempCorr) 


AdB Computed Average AGCKu - Reference (TempCorr) 


B Computed Average AGCC - Reference (TempCorr) 


n/a Settable Flag Used for Ignoring Bad Data 


Table C-3 AIF Events Report Format 


Field 

Fmt 

Units 

Description 

day 

17 

YYYYDDD 

Year and Julian Day 


FI 3.2 

n/a 

UTC Seconds 

ATB 

A17 

n/a 

Full UTC ASCII Time 

EventSource 

A3 

n/a 

Source of Event (SCI/ENG) 

EventClass 

A6 

n/a 

Level of Event Severity (Danger/Warn/Status, etc) 

Description 

A?? 

n/a 

Description of Event 
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utcsec 


Table C-4 AIF ENG Database/Eng Averages Format 


seconds 


Description 


Average UTC Seconds 


YYYYDDD Year and Julian Day 

n/a Database Link 


Database Link 


records 


tempo 1 
temp02 
tempos 

temp04 


tempos 


tempos 


tempo? 


tempos 


tempos 


tempi 0 


tempi 1 


tempi 2 


tempi 3 


tempi 6 


tempi? 
tempi 8 
tempi 9 


temp20 

temp21 




Number of Records Used to Compute Averages 
Type of Statistic (Min/Max/Mean) 

Statistic for Temp Monitor - spare 
Statistic for AGC Receiver Section Temp 
Statistic for SSU Temp 
Statistic for Ku MTU IF Preamp Temp 


Statistic for Receiver IQ Video Section Temp 
Statistic forTWTA EPC Temp #1 


Statistic for Temp Monitor - spare 
Statistic for C MTU Cal Attenuator Temp 


Statistic for C MTU RF Preamp Temp 


Statistic for C MTU IF Preamp Temp 


Statistic forC MTU Power Monitor Temp 


Statistic for C-SSA GaAs FETS Temp 


Statistic for C-SSA Power Converter Temp 
Statistic for Ku MTU Cal Attenuator Temp 
Statistic for Ku MTU Power Monitor Temp 
Statistic for UCFM Temp 


Statistic for Ku MTU RF Preamp Temp 

Statistic for Downconverter Temp 

Statistic for Signal Proc DFB Butterfly Brd Temp 


Statistic for Signal Proc DFB Memory Temp 


Statistic for Signal Proc ICA Condition Amps Temp 
Statistic for Signal Proc A/D Converter Temp 


Statistic for Signal Proc Synchronizer Temp 
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Table C-4 

AIF ENG Database/Eng Averages Format (Continued) 

Field 


Description 

temp24 

F6.2 

DegC 

Statistic for Signal Proc ATA Temp 



DegC 

Statistic for Signal Proc Housing Wall Temp 



DegC 

Statistic for Digital Chip Generator Gate Array Temp 

temp27 

F6.2 

DegC 

Statistic for LVPS Mounting Plate Temp 

temp28 

F6.2 

DegC 

Statistic for LVPS Boost Regulator Assembly Temp 

monOI 

F10.6 

Qjj 

s 

Statistic for LVPS -i-12V 

mon02 

FI 0.6 

an 

s 

Statistic for LVPS +28V 

mon03 

FI 0.6 


5 

Statistic for LVPS +15V 

mon04 

F10.6 


5 

Statistic for LVPS -15V 

monOS 

F10.6 

QQ 

5 

Statistic for LVPS +5V (5%) 

mon06 

FI 0.6 


S 

Statistic for LVPS +5V (1%) 

mon07 



S 

Statistic for LVPS -5.2V 

monOB 

F10.6 

B 

5 

Statistic for LVPS -6V 

mon09 

F10.6 


ts 

Statistic for Ku Xmlt Power (TempCorr) 

monlO 

FI 0.6 


5 

Statistic for TWTA Cathode Voltage 

monll 

FI 0.6 


)S 

Statistic for TWTA Cathode Current (TempCorr) 

mon12 

FI 0.6 

IQ 

)S 

Statistic for TWTA Helix Current 

mon13 

FI 0.6 


)S 

Statistic for TWTA Bus Current 

mon14 

F10.6 


ts 

Statistic for C Xmlt Power 


mon16 


mon17 


useflag 



Statistic for C-SSA Input RF Power (TempCorr) 


Statistic for C-SSA Bus Current (TempCorr) 


Statistic for LVPS Bus Current 


Settable Flag Used for Ignoring Bad Data 
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Table C-5 AIF Waveform Differences Database/Check WF Format 


Field 

Fmt 

Units 

Description 

utcsec 

FI 6.2 

seconds 

Average UTC Seconds 

day 


YYYYDDD 

Year and Julian Day 

mode 

A4 

n/a 

Mode 

numrec 

14 

rewcords 

Number of Records Used to Compute Averages 

gated 

F7.2 

Acounts 

Computed WF Gate #1 Average - Reference 

gate02 

F7.2 

Acounts 

Computed WF Gate #2 Average - Reference 

gate03 

F7.2 


Computed WF Gate #3 Average - Reference 

gate04 

F7.2 


Computed WF Gate #4 Average - Reference 


• 



gate61 

F7.2 

Acounts 

Computed WF Gate #61 Average - Reference 

gate62 

F7.2 

Acounts 

Computed WF Gate #62 Average - Reference 

gate63 

F7.2 

Acounts 

Computed WF Gate #63 Average - Reference 

gate64 

F7.2 

Acounts 

Computed WF Gate #64 Average - Reference 

tempOl 

F7.2 

degC 

Mean of AGC Receiver Section Temperature 


Table C-6 DataFile.SEU Format 


Field 

Fmt 

Units 

Description 

ATB 

A17 

n/a 

Full UTC ASCII Time of SEU 

Latitude 

F6.2 

degrees 

Latitude of SEU 

Longitude 

F6.2 

degrees 

Longitude of SEU 


A1 

n/a 

Type of Reset (A=Automatic, M=Manual) 


A17 

n/a 

Time of Manual Reset 

HoursLost 

F6.2 

Hours 

Number of Track Hours Lost due to Reset 

Mode 

A4 

n/a 

Altimeter Mode Prior to Reset 

Description 

n/a 

n/a 

Description of Reset 
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Table C-7 AIF Waveform Averages Format 


Field 

Fmt 

Units 

Description 

utcsec 

F16.2 

seconds 

Average UTCSeconds 

ATB 

A17 

n/a 

Full UTC ASCII Time 

year 

A3 

n/a 

Last 3 Digits of Year 

day 

A3 

n/a 

Julian Day of Year 

step 

14 

n/a 

CAL Mode Step (Valid only if Mode=CAL1 ) 

mode 

A4 

n/a 

Mode 

numrec 

14 

records 

Number of Records Used to Compute Averages 

gateindex 

14 

n/a 

Computer Gate Index Average 

vswh 

F14.2 

counts 

Computed VSWH Average 

finehgt 

F14.2 

mm 

-- ] 

Computed Fine Height Average 

gated 

F14.2 

counts 

Computed WF Gate #1 Average 

gate02 

F14.2 

counts 

Computed WF Gate #2 Average 

gate03 

F14.2 

counts 

Computed WF Gate #3 Average 

gate04 

F14.2 

counts 

Computed WF Gate #4 Average 





gate61 

FI 4.2 

counts 

Computed WF Gate #61 Average 

gate62 

F14.2 

counts 

Computed WF Gate #62 Average 

gate63 

FI 4.2 

counts 

Computed WF Gate #63 Average 

gate64 

F14.2 

counts 

Computed WF Gate #64 Average 
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Table C-8 AIF Sci Averages Format 


Description 


seconds 


Average UTC Seconds 


Year and Julian Day 


Database Link 


Number of Records Used to Compute Averages 


Worst Mode Detected in Interval 


Best Mode Detectewd in Interval 


unused 


unused 


ModeFlag 


OOEFlag 


OrderFlag 


RTMS of AltHgtKu, computed with Hayne Method 


RMS of AltHgtKu-C, computed with Hayne Method 


Average of AltHgtKu 


Average of AltHgtC-AltHgtKu 


Average of SWHKu 


Average of SWHC 


Average of VSWHKu 


Average of VSWHC 


Average of AGCKu (TempCorr) 


Average of AGCC (TempCorr) 


Average of AltHgtRate 


Average of GateIndexKu 


Average of GateIndexC 


Average of AttEstWF 


Number of ALL recs with T1016 AGC, SWH, or Hgt Flags 


unused 


Number of ALL Records with LimitByte * 0 


Number of ALL Recs with FlgMode1068 or FlgTrack1068 


unused 


unused 


Number of ALL Heights with FlgBln1016C 


I 
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FIgBlnl 01 6K 

I4 

flags 

FIgEaHgtC 

I4 

flags 

FIgEaHgtK 

I4 

flags 

FIgVAttKu 

I4 

flags 

FIgVAttC 

14 

flags 

UTCConv 

I4 

n/a 

FlgHi5110 

I4 

flags 

RgLoSnO 

I4 

flags 

usefiag 

LI 

n/a 


Table C-8 AIF Sci Averages Format (Continued) 


Description 


Number of ALL Heights with FIgBlnl 01 6Ku 
flags Number of ALL Heights with FIgEaHgtl 01 6C 

flags Number of ALL Heights with FIgEaHgtl 01 6Ku 

flags Number of GOOD Raecords with FIgVAttKu 

flags Number of GOOD Records with FIgVAttC 

n/a unused 

flags Number of GOOD Waveforms with FIgHiS1 1 0 

flags Number of GOOD Waveforms with FIgLoS1 1 0 

n/a Settable Flag Used for Ignoring Bad Data 


Table C-9 AIF ENG Dump Format 


Description 


n/a 

Engineering Record Number 

n/a 

Full UTC ASCII time 

seconds 

Time of Spacecraft On-Board Clock 

seconds 

UTC Seconds 

seconds 

Time of Last Reset 

n/a 

Altimeter Currently operating (A/B) 

n/a 

Engineering Memory Checksum (in hex) 



EngMode 


BiLevels 

LastCMDI 

LastCMD2 

LastCMDS 

LastCMDA 


LastCMDS 


LastCMDS 


LastCMD? 


LastCMDS 


MemAddr 



Current Mode 
BiLevel Words (in Hex) 

Last command #1 , Type, Command, Status 
Last Command #2, Type,Command, Status 


Last Command #3, Type, Command, Status 


Last Command #4, Type, Command, Status 
Last Command #5, Type, Command, Status 


Last Command #6, Type, Command, Status 


Last Command #7, Type, Command, Status 


Last Command #8, Type, Command, Status 


Memory Dump Address (in Hex) 
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Table C-9 AIF ENG Dump Format (Continued) 


Field 

Fmt 

MemDump 

32A2 

tempo 1 

F6.2 

temp02 

F6.2 

tempos 

F6.2 

temp04 

F6.2 

tempos 

F6.2 

tempos 

F6.2 

tempo? 

F6.2 

tempos 

F6.2 

temp09 

F6.2 

tempi 0 

F6.2 

tempi 1 

F6.2 

temp 12 

F6.2 

tempi 3 

F6.2 

tempi 4 

F6.2 

tempi 5 

F6.2 

tempi 6 

F6.2 

tempi? 

F6.2 

tempi 8 

F6.2 

tempi 9 

F6.2 



temp20 

temp21 


temp23 


temp24 


temp25 


temp26 


temp27 


temp28 


monOI 


Units 

Description 

n/a 

Memory Dump (in Hex) 


Average of Temp Monitor - spare 


Average of AGC Receiver Section Temp 

DegC 

Average of SSL) Temp 

DegC 

Average of Ku MTU IF Preamp Temp 

DegC 

Average of Receiver IQ Video Section Temp 

DegC 

Average of TWTA EPC Temp #1 

DegC 

Average of Temp Monitor - spare 

DegC 

Average of C MTU Cal Attenuator Temp 

DegC 

Average of C MTU RF Preamp Temp 

DegC 

Average of C MTU IF Preamp Temp 

DegC 

Average of C MTU Power Monitor Temp 

DegC 

Average of C-SSA GaAs FETsTemp 

DegC 

Average of C-SSA Power Converter Temp 

DegC 

Average of Ku MTU Cal Attenuator Temp 

DegC 

Average of Ku MTU Power Monitor Temp 

DegC 

Average of UCFM Temp 

DegC 

Average of Ku MTU RF Preamp Temp 

DegC 

Average of Downconverter Temp 

DegC 

Average of Signal Proc DFB Butterfly Brd Temp 

DegC 

Average of Signal Proc DFB Memory Temp 

DegC 

Average of Signal Proc ICA Condition Amps Temp 

DegC 

Average of Signal Proc A/D Converter Temp 

DegC 

Average of Signal Proc Synchronizer Temp 

DegC 

Average of Signal Proc ATA Temp 

DegC 

Average of Signal Proc Housing Wall Temp 

DegC 

Average of Digital Chip Generator Gate Array Temp 

DegC 

Average of LVPS Mounting Plate Temp 

DegC 

Average of LVPS Boost Regulator Assembly Temp 

Volts 

Average of LVPS +12V 
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Table C-9 AIF ENG Dump Format (Continued) 


mon13 


mon14 


mon15 


mon16 

mon17 


useflag 


synctime 

sciclk 

sciutc 

ATB 


AltOper 

KuOn 

COn 


WFFreqHi 


WFFreqLo 


Field 

Fmt 

Units 

Description 

mon02 

F10.6 

Volts 

Average of LVPS -(■28V 

mon03 

F10.6 

Volts 

Average of LVPS +15V 

mon04 

F10.6 

Volts 

Average of LVPS -15V 

mon05 

F10.6 

Volts 

Average of LVPS +5V (5%) 

mon06 

F10.6 

Volts 

. 

Average of LVPS +5V (1 %) 

mon07 

F10.6 

Volts 

Average of LVPS -5.2V 

mon08 

F10.6 I 

Volts 

Average of LVPS -6V 

mon09 

F10.6 I 

Watts 

Average of Ku Xmit Power (TempCorr) 

mon10 



Average of TWTA Cathode Voltage 



F8.2 

FI 6.4 

F16.4 

F16.4 

A17 

A1 

A3 

A3 


A2 


A2 


Average of TWTA Cathode Current (TempCorr) 


Average of TWTA Helix Current 


Average of TWTA Bus Current 
Average of C Xmit Power 


Average of C-SSA Input RF Power (TempCorr) 


Average of C-SSA Bus Current (TempCorr) 


Average of LVPS Bus Current 


Settable Flag used For Ignoring Bad Data 


Table C-1 0 AIF SCI Dump Format 



seconds 


seconds 


records 

n/a 



Description 


Science Record Number 


Time used by Science/Engineering Synchronization 


time of Spacecraft On-Board Clock 
UTC seconds 


Full UTC ASCII Time 


Current Altimeter Operating (A/B) 


State of Ku-Band (ON/OFF) 


State of C-Band (C10/C32/OFF) 


High Rate Frequency (Ku/C) 


Low Rate Frequency (Ku/C) 
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Table C-10 AIF SCI Dump Format 


Field 


Mode 


Track 
AGCType 
Step 
GateIndexKu I 14 


CALAttenK 



CurrMode 


ModeChg 


LimitByte 


TestMode 


OperMode 


LastATA 


LastICA 


AltHgtKu 


AltHgtC 


AGCKu 


AGCC 


HgtRate 


SWHKu 


SWHC 


VSWHKu 


VSWHC 


HgtRate 


14 

n/a 

14 

n/a 

18 

n/a 

18 

n/a 

18 

n/a 

18 

n/a 

18 

n/a 

18 

n/a 

A8 

n/a 

A8 

_ . 1 

n/a 

F16.4 

mm 

F16.4 

mm 

F16.4 

dB 

F16.4 

dB 

FI 6.4 

meters/sec 

FI 6.4 

I 

meters 

F16.4 

meters 

FI 6.4 

counts 

FI 6.4 

counts 

F16.4 

meters/sec 


Description 

Current Mode 
Current Track Type 


Current AGC Type 


Current CAL Step (Only Valid if Mode=CAL1) 

GateIndexKu 

GateIndexC 

CAL Attenuator Setting Ku 
CAL Attenuator Setting C 
Interger Value of Current Mode Byte 
Integer Value of Mode Change Byte 


Integer Value of Sync Mode Byte 


Integer Value of Limit Byte 


Integer Value of Test Mode Byte 


integer Value of Operation Mode Byte 


Last ATA Command Received 


Last ICA Command Received 



Average of AGCKu (TempCorr) 


Average of AGCC (TempCorr) 


Average of AltHgtRate 


SWHKu 


SWHC 


VSWHKu 


VSWHC 


AltHgtRate 
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Table C-1 1 AIF Cal Waveform Monitor Database 


Field 


utcsec 


fileid 


wffid 


hdrid 


step 


mode 


Fmt 


FI 3.2 


A7 


Units 


seconds 


YYYYDDD 


a 


n/a 


n/a 


n/a 


records 


mm 


Scaled 


Scaled 


Description 


Average UTC Seconds 


Year and Julian Day 


CALI Step (16) 


Mode CALI only 


Number of Records Used to Compute Averages 


Altimeter Height 


Average of AGC 


Mean of AGC Receiver Section Temperature 


WFGate#1 Step Average 


WF Gate #2 Step Average 


WF Gate #3 Step Average 


WF Gate #4 Step Average 


reccount 

F4.0 

Height 

F16.4 

AGC 

F8.4 

Temp 

F8.4 

gated 

F14.3 

gate02 

F14.3 

gate03 

! F14.3 

gate04 

F14.3 


gates 1 

F14.3 

Scaled 

WF Gate #61 Step Average 

gate62 

F14.3 

Scaled 

WF Gate #62 Step Average 


F14.3 

Scaled 

WF Gate #63 Step Average 


F14.3 

Scaled 

WF Gate #64 Step Average 
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Appendix D 

Plots of Reference Values 


This appendix contains plots of the reference values used during AIF processing. 
These plots were generated by an IDL program that reads DataFile.EALimits and 
extracts from it the CAL and Waveform references. 
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Appendix E 

AIF Software 


Table E-1 AIF Software Change History 


Data f^®*3ted Software 

Affected Compor»ent(s) 


06/07/93 I 1992234 


06/09/93 1993120 


08/03/93 


08/10/93 


09/08/93 


10/01/93 


12/09/93 


DataFiie.EALimits 


1993214 93/233 dotelem 

aifcal.pro 
DataBle.EALimits 


93/234 aifeng.pro 


New Version 

Description of Changes 

3.0, 03/01/93 

Baseline Version. Includes CAL1 Attenuator tem- 
perature correction. 

13.0,05/11/93 

Baseline version. 

6.0. 05/25/93 

Baseline version, 

1.2,11/30/92 

Baseline version. 

3.2 ,05/18/93 

New Height RMS method implemented (see 
Hayne/Brooks memos). Some previous data were 
reprocessed with the new version of dotelem. 

3.3, 07/20/93 

Fix T31 17 AGC Temperature corrections problem. 

n/a 

Reduced number of daily CAL plots. 

6.0, 08/17/93 

Fix AGC CAL Reference values to match new data 
to previous uncorrected AGCs. 

n/a 

Add delta transmit power plots to Launch-to-Date 
engineering package. 

n/a 

Change labeling on Launch-to-Date plots. 


AIF Processing Officially Placed Under Change Control, Memo 10/01/93, H. Gordon 


93/280 

dotelem 

3.4, 12/08/93 

93/279 

DataFile.ROMMap 

1.3, 12/08/93 

93/299 

ge^plbin 

n/a 


Switched from DECNET to FTP protocols for data 
transfer from JPL. 


I 
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Appendix F 

Attachments 


Table F-1 List of Attachments 



Date 

Author(s) 

Subject 

October 1998 

J.Lee/D. Lockwood 

JPL SPAT Display Instructions (Revised) 

October 1998 

J.Lee/D. Lockwood 

AIF Retrieval & STANDARD Processing Instruc- 
tions (Revised) 

October 1998 

J.Lee/D. Lockwood 

SPECIAL Processing Instructions (Revised) 

March 4, 1993 

G.S. Hayne 

Estimating Ku Range Noise 

June 21, 1993 

G.S. Hayne 

TOPEX Waveform Fitting Program fittpx 

September 29., 1993 

G.S. Hayne 

Needed Corrections to TOPEX Waveform Fitting 
Program fittpx 

October 1, 1993 

H. Gordon 

Change Control Status ffor AIF Processing Mod- 
ule 

October 1 , 1 993 

J. Lee, D. Lockwood 

AIF Processing 

October 6, 1 993 

J. Lee 

Suggested Correction to AIF Processing 

December 9, 1 993 

H. Gordon 

EA S/W Change 4: Memory map 

December 9 , 1993 

H. Gordon 

EA S/W Change 5: Memory Dump Address 

Decembers, 1993 

J. Lee, D. Lockwood 

Emergency TOPEX AIF Processing change 
request 

December 9, 1993 

H. Gordon 

EA Sm Change 6: JPDWFF File Transfer 

Decembers, 1993 

J. Lee, D. Lockwood 

Final JPL SPAT Displays and Instrument File 
Retrieval & Processing instructions 

January 20, 1994 

J. Lee, D. Lockwood 

RE: Change Request for AIF Processing Module: 
CAL Plot Change 

January 24, 1994 

J. Lee, D. Lockwood 

RE: Change Request for AIF Output of Last Time 
Reset - Revisited 

January 25, 1994 

J. Lee, D. Lockwood 

RE: Request 94/010 

January 25, 1994 

J. Lee, D. Lockwood 

RE: Request 94/007 

January 25, 1994 

J. Lee, D. Lockwood 

RE: Request 94/008 

January 25, 1 994 

J. Lee, D. Lockwood 

RE: Request 94/01 1 

February 1, 1994 

H. Gordon 

EA S/W Change 10: Last Reset Time of Day 
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Table F-1 List of Attachments (Continued) 


Author(s) 


February 1 , 1 994 

H. Gordon 

February 1, 1994 

H. Gordon 

February 1 , 1 994 

H. Gordon 

March 21, 1994 

H. Gordon 

May 26, 1994 

R. Brooks, J. Lee 

May 27, 1994 

J. Lee, D. Lockwood 

June 3, 1994 

R. Brooks 

June 28, 1994 

i 

1 

1 

G.S. Hayne 

July?, 1994 

G.S. Hayne 

September 21, 1994 

H. Gordon 

September 21 , 1 994 

H. Gordon 

September 21, 1994 

H. Gordon 

January 17, 1995 

J. Lee 

February 24, 1 995 

J. Lee 


Subject 

EA S/\N Change?: Waveform Monitoring 

EA SA/V Change 8: SEU Monitoring 

EA SA/V Change 1 1 : CAL Plot Change 

EA SA/V Change 9: Error Reset Mnemonics 

Temperature Corrections for Side-B CA-1 Ku and 
C AGC 

Suggested Corrections to AIF Processing; Full 
Rate Waveforms 

Implementation of Temperature Correction Coeffi- 
cients for Side-B CAL-1 Ku and C AGC 

Corrections to Range Bias Determined in TOPEX 
Calibration Mode 1 

Replacement Figure 3 for DRAFT Memo “Correc- 
tions to Range Bias Determined in TOPEX Cali- 
bration Mode r of 28 June 1994 

EA SA/V Change 15; AIF Waveform Processing 
Correction 


EA SAA/ Change 20; Side B Temperature Correc- 
tion Coeffs. 


EA SA/V Change 19: New CAL Processor 


RE: Request 94/193 
Change Request 95/045 
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JPL SPAT Display Instructions 

Note: Requests for ALT Science and Engineering instrument files should be directed to 
the TOPEX Data Analyst Office at 818/393-0701. 

1 . Launch the TCP/Connect II - click on its icon. 

2. For EACH display you wish to view, perform steps 3 through 1 1 . 

3. Under Terminal on the menu bar at the top of the screen, select Connect. 

4. In the Session Name text field, type 128.149.96.13 and click the “OK” button. 

5. Press the [return] key once to get TGSA’s attention. 

User Name : t opssvs’) and press the [return] key at the Username: prompt. 

Password’. ) and press the [return] key at the Password: prompt. 

(^Password cannot be published but must be obtained from a cognizant TOPEX team 
member.) 

Note: If there are errors made in entering usemame/password attempts, the jpl system will 
temporarily lockout user for a period of time. After an undetermined amount of time, the 
system will accept another attempt. 


TCP/Connect II VT102 Emulation Keys 

VT102 Key 

Mac Keyboard 

enter 

[enter] on numeric keypad 

PFl 

[clear] on numeric keypad 

PF2 

[=] on numeric keypad 

PF3 

[/] on numeric keypad 

PF4 

[*] on numeric keypad 


[0] on numeric keypad 

KPl 

[1] on numeric keypad 

KP2 

[2] on numeric keypad 

KP3 

[3] on numeric keypad 

KP4 

[4] on numeric keypad 

KPS 

[5] on numeric keypad 

KP6 

[6] on numeric keypad 

KP7 

[7] on numeric keypad 

KPS 

[8] on numeric keypad 

KP9 

[9] on numeric keypad 

KP. 

[.] on numeric keypad 
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TCP/Connect II VT102 Emulation Keys 

VT102 Key 

Mac Keyboard 

Up 

[ ] on cursor keypad 

Down 

[ ] on cursor keypad 

Left 

[ ] on cursor Keypad 

Right 

[ ] on cursor Keypad 


6. Follow on-screen instructions until you get to the TCCS MAIN MENU. 

7. Press the [enter] key on the numeric keypad to access the TELEMETRY menu. 

8. Follow Step 9 to choose from a list of displays, or Step 10 to view a “standard” display. 

9. Press the [Down] key three times to hilight TLM3 VIEW CHANNEL DATA (LIST 
OF DISPLAYS). 

Press the [enter] key on the numeric keyboard to select this choice. 

Press the [KP.] key. 

Type SPAT* in response to Where DISPLAY_NAME is. 

Press the [PF3] key to execute the query. 

Use the [Up] and [Down] keys to hilight the desired screen. Note: using the [Up] key to 
scroll backwards may produce strange results. 

Press the [PFl] then [KP4] keys to select your choice. The selected display should now 
be viewable on screen. 

10. Press the [Down] key two times to hilight TML2_1 VIEW CHANNEL DATA -DUAL 
COLUMN. 

Press the [enter] key to select this choice. 

Press the [KP.] key. Type one of the following choices in response to DISPLAY_NAME 
is. For example, SPAT-ALTAC. 


“Standard” Displays 

Name 

Description 

SPAT-ALTAC 

ALT-A Command Words 

SPAT-ALTAD 

ALT-A Memory Dump 

SPAT-ALTAP 

ALT-A Powers 

SPAT-ALTRS 

S/C & RESET Times & SCI Word 
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Press the PFl and KP4 keys to confirm your choice. The selected display should now be 
viewable on-screen. 

1 1 . You may move the display screen windows around by clicking on the title bar and drag- 
ging the mouse. The title bar is the area at the top of the window that contains 
“128.149.96.13” surrounded by faint lines. 

12. To exit, for each window, “back-out” of TGS system by pressing subsequent [PFl] then 
[KPO] keys. 

Note; at screen bottom ; At HOME level, now exiting. Are you sure (y/n): [return]. 

13. Under File on the menu bar at the top of the screen, select QUIT to exit TCP/Connect II. 
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AIF Retrieval & STANDARD Processing Instructions 

Note: Requests for ALT Science and Engineering instrument files should be directed to 
the TOPEX Data Analyst Office at 818/393-0701. 

Definitions 

UTC: Coordinated Universal Time. Time is represented in the format 
“YYY YDDDtHHMMSS”, where YYYY represents year, DDD represents the Julian day 
of the year, and HHMMSS represents hours, minutes, and seconds. Eastern Standard Time 
= UTC Time - 5 hours. For example; 1993285t060203 represents October 1 2, 1 993 at 
01;02;03 EST. 

fileutc: The UTC portion of a filename. JPL creates their AIF filenames by using the UTC 
of the start of the data. 

filename: The name of a file. Standard filenames consist of a prefix, a fileutc, and a suffix, 
where the prefix and suffix identify the file type. 

Instructions 

14. Log on to osb3 by doing the following; 

Select TCP/Connect - click on its icon 

Under Terminal on the menu bar at the top of the screen, select Connect . 

Session Name; osb3 [select “ okav ”l (Note; It is not necessary to enter information for 
Window Name;) 

Login: fuser namei [return] 

Pswd: (user password') [return] 

15. Your path must be able to access several binaries and the IDL_PATH. 

Type; setenv PATH /gen/topex2/bin:/opt/bin:$PATH [return] 

Type; source /optfidl/bin/idl_setup [return] 

1 6. Change to the AIF processing directory. 

Type; cd /gen/topex2/aif [return] 

17. To see what files are available at JPL. 

Type; Isjplaif [return] 

18. Run the automated daily processing system. This will take approximately 1.5 hours for a 
full 24-hour AIF. 

Type; stdaif [return] 

(note; fileutc would be in the format as YYYYDDDtHHMMSS.) 
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The automated daily processing will print the following products: 

aifsci, the daily science product 

dailyeng, the daily single-page engineering product 

aifcal, the daily CAL mode product 

aifhdr, the processing summary 

aifevents, the events listing 

It will also create the following output files for any additional processing: 

aif_eng^fe«/c.std, 5-minute engineering averages. 

aif_sci Jileutcstd, 10-second science averages. 

aif_event Jileutcsid, an event report. 

aif en g fi leutcAh. 1 -hour engineering averages. 

aif_cal JileutcAh, CAL mode averages. 

aif_hdr JileutcAh, a header report 

19. If more engineering parameters need to be examined, run the idl program that plots all 
engineering parameters. 

Type: sdfeng filename, where filename is of the form aif eng fUeutcsid. 

20. If other types of processing is required, see SPECIAL Processing Instructions. 

21. If task is completed, type: exit. Then, under File on menu bar, select Quit. 
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SPECIAL Processing Instructions 

Note: Requests for ALT Science and Engineering instrument files should be directed to 
the TOPEX Data Analyst Office at 818/393-0701. 

Definitions 

UTCi Coordinated Universal Time. Time is represented in the format “YYYYDDDtH- 
HMMSS”, where YYYY represents year, DDD represents the Julian day of the year, and 
HHMMSS represents hours, minutes, and seconds. Eastern Standard Time = UTC Time - 5 
hours. For example: 1993285t060203 represents hours, minutes, and seconds. Eastern Stan- 
dard Time = UTC Time - 5 hours. For example: 1993285t060203 represents October 12, 1993 
at 01:02:03 EST. 

fileutc: The UTC portion of a filename. JPL creates their AIF filenames by using the UTC of 
the start of the data. 

filename: The name of a file. Standard filenames consist of a prefix, a fileutc, and a suffix, 
where the prefix and suffix identify the file type. 

Instructions 

1 . Log on to osb3. 

2. Your path must be able to access several binaries and the IDL_PATH. 

Type: setenv PATH /gen/topex2/bin:/opt/bin:$PATHIretum] 

Type: source /opt/idl/bin/idl_setup 

3. Change to the AIF processing directory. 

Type: cd /gen/topex2/aif [return] 

4. You can check to see what files are available at JPL. 
type: Isjplaif 

5. If you haven’t already retrieved the data, retrieve the Engineering Instrument File. 

Type: getjpibin ‘14.429::WFFDEV:[WFFUSER.WFF_DATA]^/ename[retum] 

Where filename is of the format tcc_alteng^/eHtcbin 

(24 hours of data takes approximately 5 minutes to retrieve) 

6. If you haven’t already retrieved the data, retrieve the Science Instrument File. 

Type: getjpibin ‘14.429::WFFDEV:[WFFUSER.WFF_DATA]^/e#iajne[retum] 

Where filename is of the format tcc_altsci _Jileutcbin 

(24 hours of data takes approximately 45 minutes to retrieve) 
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7. dotelem requires UTC Seconds for time selections. If you wish to do a time selection and 
don’t know UTC Seconds, run utcconvert to convert from UTC Clock Time to UTC Sec- 
onds. Remember, Eastern Standard Time = UTC Time - 5 hours. 

Convert the start time . 

Type; utcconvert 

Type: 2 [return] in response to Select UTC Time to Enter 

Type; VTC in response to Enter UTC in the format YYYYDDDtHHMMSS 

Write down the time in seconds. You won’t be able to remember it. 

Type: [return] in response to Press RETURN to Continue 

Convert the stop time . 

Type; 2 [return] in response to Select UTC Time to Enter 

Type: VTC in response to Enter UTC in the format YYYYDDDtHHMMSS 

Write down the time in seconds. You won’t be able to remember it. 

Type: [return] in response to Press RETURN to Continue 

Type: x [return] in response to Select UTC Time to Enter in order to exit. 

8. Run dotelem. Follow the on-screen menus to select what processing you wish to perform. 
Note that selecting by Latitude/Longitude does not work. The names of the output files 
will be printed on the screen after your processing selections are complete. They will also 
be written into an aif_???.log file. Write down the output filenames and wait until proces- 
ing is complete. 

Type: dotelem and follow on-screen instructions. 

Type: x[return] in response to Enter File Type to exit. 

9. Use the following table to choose what output command corresponds to your processing 
selection. Run that command by typing it. 
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Table of Processing Selections & Output Commands 

Processing Selection 

Output Command 

Description/Comment 

0. Do Standard Processing 

n/a 

Previously documented. 

1 . Create AIF Databases 

n/a 

No output commands available. 

2. Dump Telemetry 

n/a 

Load into spreadsheet of view 
on-screen. 

3. Average Science Data 

aifsci filename 

Plot science data. 

4. Average Engineering 
Data 

aif eng filename 
daily eng filename 

Plot single-page selected engi- 
neering data. 

5. Average Waveform Data 

topexautowf filename 
topexwf filename 

Plot auto-scaled waveforms. 
Plot fixed-scale waveforms. 

6. Report Status Changes 

n/a 

Print or view on-screen. 

7. Create SDR 

n/a 

No output commands available. 
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WFF TOPEX INFORMAL MEMORANDUM 
Date: March 4, 1993 

From: G. S. Hayne 

To: R. L. Brooks, D. W. Hancock, & C. Purdy 

Subject: Estimating Ku Range Noise 


Introduction 

David Hancock suggested that we might be able to assess the range noise of the 
TOPEX Ku altimeter by using noise estimates of the Ku ionospheric correction, Le., the term 
which is subtracted from the Ku range to remove the effects of ionospheric propagation delay. 
First ru review what everybody knows about the two-frequency altimeter, and then I will 
show that the noise of the Ku ionospheric correction can be simply scaled to estimate the Ku- 
only range noise if one knows the ratio of the C320-only range noise to the Ku-only range 
noise. 

General Review 

The radar propagation to/frora the ocean surface is retarded by an amount proportional 
to the free electron content of the propagation path and inversely proportional to the radar 
frequency. In general, the Ku altimeter's range can be written as 

'‘k = ^0 + "k* 

rQ is the true range, Q is proportional to total electron content (TEC), fjr is the Ku altimeter's 
frequency, and nj^ is a zero-mean noise term with the expectation values (n^r) = 0, and 
<"K^> = V- A similar equation describes the C altimeter range as 

with similar noise properties (n^) = 0, and (n^^) = 

These two equations can be solved for the true range rQ with the result 
rg = (K/(K-l))rK - (l/(K-l))rc, where K = {f^/fc)^- 
It can also be shown that the standard deviation of rg, denoted Og, i|p given by 
Og = (K^Oj,^ -H Ocy* /(K-1). 

Finally, the Ku ionospheric bias term Q/f^ can be expressed as 

r\/r‘ 2 


Ku range noise ... 
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and the C320 ionospheric bias term as 

Q/fc^ = (rc - ■ 1)- 

Since it is easy to show that the standard deviation of (r^ - rj^) is (Cj^ h- ) . then the 
standard deviation of the Ku ionospheric bias term is 

+ acYV(K-l)]. 

and the standard deviatipn of the C320 ionospheric bias term is 
^i.C = + 0'“^' K/(K-1)]. 


Practical Range Noise Estimates 

We can invert the Ku ionospheric term's standard deviation to find that the Ku-only 
range standard deviation can be written as 

= A , where 

A = (K - 1)/(1 + 

Then the combined (or ionosphere-corrected) range standard deviation Oq can be written as 
Gq = B , where 
B = [ (K^ + / [ (1 + 

In most of the Topex data, we expect Oq to somewhere in the range of one to two times Cj^. 
Table 1 gives values of the multipliers A and B for several values of the ratio with 

the frequency ratio factor K evaluated with frequencies of 13.6 GHz for Ku and 5.3 GHz for 
C320. 


Table 1. Factors A and B for different values 


dc/Oj^ 

1 

1.2 

1.4 

1.6 

1.8 

2 

A 

3.95 

3.58 

3.25 

2.96 

2.71 

2.50 

B 

4.71 

4.28 

3.91 

3.59 

3.32 

0 

CO 


Example • 

Figure 1 plots the I-second standard deviation of the Ku ionospheric correction, Ojj^, 
from a series of 30-second averages of data from TOPEX pass 21 of cycle 8. Figure 2 is the 
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SDR summary plot for the same pass. Several large outliers have been eliminated from the 
Figure 1 data. It is possible to argue that the quietest regions of Figure 1 showed Oj values 
of 0.005 meters. If we assume = l-O, then A = 3.95 so that is 3.95 times 0.005 

meters or 1.98 cm; likewise B = 4.71 so that Oq is 4.71 times .005 m or 2.35 cm. 

Conclusion 

This memo has shown a simple way of estimating Topex Ku-only range noise or 
combined Ku-C range noise to noise estimates of the Ku ionospheric correction. This method 
would be a good candidate for producing range noise estimates for the next version of the 
Topex data base here at WFF. 
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CYCLE 8, PASS 21 

Input File; sdr_sci_008_021 .std 
NumRec =348, Intervol = 10 
Summary created Wed Jon 20 20:29:56 *• 9 
SDR Software = Version 3.0, 01/14/93 
SensorVersion = Version' 10, 10/27/92 
EALimVersion = Version 05, 01/19/93 
ROMVopVersion = Version 1.2, 11/30/92 
SISJO = 633-751 -23-001/1992-05-15 
ALT_SDR_SW_PED= 633-755/1992- 11 -25 
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WFF TOPEX INFORMAL MEMORANDUM 


Date: June 2l, 1993 

From: George Hayne 

To: Dennis Lockwood 

cc: Ron Brooks, Ron Forsythe, Hayden Gordon, David Hancock 

Subject: TOPEX Waveform Fitting Program fittpx3 


This memo is a brief description of the current TOPEX waveform fitting 
program which is called fittpx3. Among the several significant changes and 
improvements in fittpx3 compared to earlier versions are: 

- all three possible altimeters (Ku, C-320, and C-lOO) are now handled 
within the single program^i 

- the waveform data to be fitted are from the output of the current version 
of Jeff Lee's TOPEX program dosdr 

- the waveform fit control file now includes the antenna beamwidth (which 
was hard-coded in the older fit program versions) 

- a substantially improved first guess is now provided for the parameter 
values which are to be fitted. 

You have somewhere an older version of a TOPEX waveform fitting program and I 
would suggest that you replace it with the fittpx3 described here. 

You will find in directory /osbnet/hayne/publi(/fitstuff all of the necessary 
files to compile, load, and execute fittpx3 on the osbl computer. Here is a list of 
the files I have provided: 

Various files in directory fitstuff, 06/21/93 


-rw-rw-rw- 

1 

hayne 

7445 

Jun 

21 

10:14 

aguessB . £ 

-rw-rw-rw~ 

1 

hayne 

562 

Jun 

21 

10:14 

c027045aoob 

-rw-rw-rw- 

1 

hayne 

1356 

Jun 

21 

10:14 

c027 045a* out 

-rw-rw-rw- 

1 

hayne 

566 

Jun 

21 

10:14 

c027045a.pnn 

-rw-rw-rw- 

1 

hayne 

8358 

Jun 

21 

10:14 

c027045a.prt 

-rw-rw-rw- 

1 

hayne 

995 

Jun 

21 

10:14 

cfpl3fl0*d 

-rw-rw-rw- 

1 

hayne 

5886 

Jun 

21 

10:14 

drvxxtpx* f 

-rw-rw-rw- 

1 

hayne 

2313 

Jun 

21 

10:14 

dsyinv. f 

-rw-rw-rw- 

1 

hayne 

12255 

Jun 

21 

10:14 

f itprm3 *f 

-rwxrwxrwx 

1 

hayne 

307725 

Jun 

21 

10:14 

f ittpx3 

-rw-rw-rw- 

1 

hayne 

25797 

Jun 

21 

10:14 

f ittpx3 . f 

-rw-rw-rw- 

1 

hayne 

1276 

Jun 

21 

10:14 

f ittpx3 .makefile 

-rw-rw-rw- 

1 

hayne 

8710 

Jun 

21 

10:14 

genwavxx. f 

-rw-rw-rw- 

1 

hayne 

8780 

Jun 

21 

10:14 

gfsrt . f 

-rw-rw-rw- 

1 

hayne 

3534 

Jun 

21 

10:14 

gseat . f 

-rw-rw-rw- 

1 

hayne 

3862 

Jun 

21 

10:14 

gsysxx- f 

-rw-rw-rw- 

1 

hayne 

3234 

Jun 

21 

10:14 

gtdata2 . f 

-rw-rw-rw~ 

1 

hayne 

210 

Jun 

21 

10:14 

inwtxx.d 

-rw-rW'Xrw- 

1 

hayne 

558 

Jun 

21 

10:14 

k027045a. job 

-rw-rw-rw- 

1 

hayne 

1356 

Jun 

21 

10:14 

k027045a.out 


-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw~rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 

-rw-rw-rw- 

1 

hayne 
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566 

jun 

21 

10:14 

8358 

Jun 

21 

10:14 

1133 

Jun 

21 

10:14 

3182 

Jun 

21 

10:14 

824 

Jun 

21 

10:14 

4725 

Jun 

21 

10:14 

4725 

Jun 

21 

10:14 

9233 

Jun 

21 

10:14 

2744 

Jun 

21 

10:14 

1349 

Jun 

21 

10:14 

2981 

Jun 

21 

10:14 

5543 

Jun 

21 

10:14 

5909 

Jun 

21 

10:14 


k027045a.pnn 
k027045a .prt 
kfpl3fl0.d 
pickt4 . f 
rlout2 . f 

sdr_wave_027_045a .hiavg 

sdr_wave_027__045a. loavg 

topwavxx. f 

txat5134.f 

txswlOSl.f 

wavtrp4 . f 

wvlOOtpx. f 

wv320tpx. f 


You can compile and load the program by executing the Unix system 
command "make -f fittpxS .makefile", and the executable module fittpxS will be 
produced in whatever directory you choose to move this stuff to. I have also 
provided two short sample waveform data files for checking program operation, 
sdr_wave_027_045a.hiavg and sdr_wave_027_045a.loavg, for the TOPl^ Ku and 
the C-320 altimeters respectively. Each of these sample files contains three 10- 
second waveform averages of over-ocean fine-track data. 

Program fittpxS has a variety of console dialog for job specification. It is 
generally easier to operate with job scripts, the set of user responses to the input 
details asked by fittpxS. I have provided job scripts k027045a.job and 
c027045a.job for running fittpxS with the sample data files, and the output files 
from these sample jobs are k027045a.prt, k027045a.prm, c027045a.prt, and 
c027045a.prm. These sample jobs were run in backgroimd on osbl by 
fittpxS <k027045a.job >k027045a.out & 
fittpxS <c027045a.job >c027045a.out & 

and the output files k027045a.out and c027045a.out are also provided. (Normally 
I discard any *.out files after the background job is completed.) These examples 
have been for lO-second waveform averages. Here is one of the “.job files, the one 
for the Ku altimeter: 

1 k027045a.prt 

2 kfpl3f lO.d 

3 1 ;;lst lin =outprint f ile; 2nd=setupf ile; YES, wts filename: 

4 inwtxx.d 

5 0 ; ;NO, accept default Version 13 gains £c additions 

6* 1 ;; Output parameters to following filename: 

7 k027045a.prm 

8 sdr_wave_027_045a .hiavg 

8 0, 0 ;;selected all records for above input filename 

10 0 ;;select all indgt values 

11 

12 File k027045a. job, a script control file for Ku job in fittopex. 

13 

14 This file is for 10-second averages with new additive 

15 waveform factors from vl3.0 final (delivered 05/12/93) 
le 
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17 revised 06/21/93 

The bold italic line numbers are not in the ’.job file itself, but I have inserted the 
numbers for this discussion. 

Except for those jobfile lines providing file names, the lines supply one or 
two numbers for a free-format read operation by the fittpxS program. The 
numbers-only lines can have comments anytime after the last number to be 
specified, and in the example above the comments are preceded by Line 1" 
above specifies the output file for eventual off-line printout if desired. Line 2 
specifies waveform fit control file, to be discussed later. Line 3 specifies whether 
another input file is to be consulted for data-weighting, and the following line 
specifies that filename (the answer in this example was 1 = yes, that the data- 
weighting file to be used was named inwtxx.d). Line 5 allows specifying different 
waveform gains and additions than the default set, but in the example the default 
set was used. 

Line 6 specifies additional output files: 0 = no other output files; 1 = output 
a file of fitted parameters to the filename on the next line; 2 = output a file of 
input and fitted waveform values to the filename on the next line; and 3 = output 
both fitted parameter and waveform files to the filenames on the next two lines.. 
In the example above, just the fitted parameter output file was requested. Line 8 
specifies the input waveform data filename. Then line 9 indicates range of data to 
be fitted (by record number). For line 9, either actual numbers can be specified 
(1,4 to process records 1 through 4), or 0,0 can be entered to denote all available 
waveform data. Finally, line 10 allows restricting the gate index values to be 
fitted. The 0 signals that all gate index values are to be fitted; otherwise line 10 
would indicate the number of separate gate index values to be fitted and a 
following line would indicate those gate index values (for example, 2 on line 10 
followed and 1 and 3 on line 11 would allow only data with gate index values of 1 
or 3 to be fitted). After the gate index values or range are specified, there is no 
more reading of the job script file, so the remainder of that file can be filled with 
file-identification comments. The source file fittpx3.f contains the code specifying 
what form the terminal (or redirected job script file) responses should have. 

The waveform fit control file used in the Ku sample fit is given below: 

5 # parameters to be fitted 

5 60 ;;low, high limit on fitted TLM samples 

12346 ;;Jordr(,) for the parameters to be fitted 


200 

0.05 0.5 

20 

0.1 0.025 

.1 

;;the fit constraints 


0 

.10 .20 

0 

.05 .025 

0. 

;; finite-step sizes for 

derivatives 

9200. 

0.00 3.0 

95. 

0.1 0.05 

0.0 

;;first guess at parameter values 

10 



;;min NumRec required (10-sec avg*s) 


5.6 

12,37 

57. 

60 

; lo,hi 

indices for Early, AGC, 

ATT gates 


1 32.5 ;;nnnalt( =1 .for Ku) k track-point 



fittpxS ... - pg 4 


1334. 1.08 ;;altitude (km) u beamwidth (degrees) 

75. 200. ;;RMSliro & BSlim, for weight calc... 

file kfpl3fl0.d revised 05/13/93 

This is a file of settings for the Topex fitting routine 
fittpx3 doing 10-second averages. The early gate for Att 
has been changed to match the simulation for Ku. about 
03/15/93. The fit is for 5-parameters, at 0.1 skewness. 

THE BEAMWIDTH IS 1.08 degrees (about 2.85% above nominal 1.05 degrees) 

The seventh line of this file gives the minimum NumRec required. For the 10- 
second fit, this requires that 10 frames (TOPEX nominal 1 second/frame) were 
used in forming the waveform average. If 5-second waveform averages are to be 
fitted, this minimum value should be changed to 5. For full-rate data or 1-second 
averages, the value would be 1. 


This memo obviously doesn't provide a complete fittpx3 description, but it 
should at least allow you to set up an operating version in your own work area. 
Please don't hesitate to come to me with questions or comments. 





WFF TOPEX INFORMAL MEMORANDUM 


Date; September 29, 1993 

From: G. Hayne 

To: Dennis Lockwood 

cc: R. Brooks, R. Forsythe, H. Gordon, D. Hancock, J. Lee 

Subject: Needed Corrections to TOPEX Waveform Fitting Program fittpxS 


In an earlier memo "TOPEX Waveform Fitting Program fittpx3", G.S. 

Hayne, June 2l, 1993, I described briefly the program, its subroutines, where to 
find them, and how to load and run the program. I had developed and used it 
exclusively on osbl, but Dennis Lockwood installed and ran it on osb4. Later, in 
analyzing data from ABCAL #21 on 09/14/93, we found that the results from osbl 
and osb4 differed significantly in the fitted value of the range correction. 

I have found the error which was in the subroutine wv320tpx. It is a 
simple parameter-setting statement which was badly written, with the original 
error being made years ago. The osbl compOer interpreted the ambiguous 
statement in the way that had been intended, but osb4 treated it differently. The 
subroutine has been fixed, as has subroutine wvlOOtpx which had the same error. 
(Subroutine wvlCX)tpx is called only if the C-lOO waveform is being fitted, and we 
have never looked at any C-lOO waveforms to date.) 

I have also made minor cosmetic changes in the main program and in the 
subroutines topwavxx and drvxxtpx. Copies of the five revised files (fittpx3.f, 
drvxxtpx.f, wvlOOtpx.f, wv320tpx.f and topwavxx.f) have been put into the area 
/osbneVlockwood/public. Please use these files to replace the earlier versions 
which were the subject of the June 1993 memo, and then recompile and reload the 
fittpxS program into the same place where the current malfunctioning version 
resides. After this, there should be no further problems with the waveform -fitting 
program. 

There are some very slight numerical differences for ABCAL #21 results 
from the osbl and the (corrected) osb4 versions, but these are not a problem. The 
maximum range correction difference was 0.5 mm, the maximum SWH difference 
was 0.002 meters, the maximum amplitude difference was 9 (out of about 9000), 
and the maxirnum baseline difference was 0.6 (out of about 100). I consider these 
acceptable for the complicated fitting procedxare, run on real data. For general 
information, I have attached a copy of a diagram showing the relationship of the 
various subroutines in program fittpx3; see me if you want a larger copy of this 
eye test figure. 



For fittpx3, the Topex waveform-fitting-to-data program, the files are listed below: 


sourc« file 

name reletion»hip of vfiom modules of fittpifJ 


type efgument* In ceUinq Bit 


finpx3.l 


.. in kbwW 

rtoUZJ 

gtdala2-l 


lkpnn3J 


a9<MSs3.t 

tnwtOStJ 

tnl5134J 

dnnodpxJ 

wv320lpx 
or wvlOOlpx 


lopwivxxJ 


genwavnJ 


gsysxxJ 


gsaatJ 

gIsrtJ 

inibMfl.- 


pidd4J 

wav1rp4J 




main pcogram 


WFF ibrary routines 


subroutine 


subrout me 


subroulme 

subroutine 

subroutine 

subroutine 

subrout me 

subroutme 

subroutine 


((device #, outpt array. • output points} 

fmode^, 7. Ir^ainid. 6. iw. Ner^, ioslal. tjiin, 
jutdime, icycte. pass, tsaep. ttfcmode. nurnrod. | 

t?!?!? J2T ! 

Jrilo. nN. yin. wty, oidbQ. iar. pdgl.'wswti. vatt. J 
• ztrkO. altkm. bwdeg. nrraH i 

I also common 4itparms/Apnm, Astep. NA. | 
I 

i^la. ind^. vswh, vatt, aii^iu^s 


,1a. ind^. vswtv vatl. atcfl. an. It^ , 

jyin, nnnaR, vsiitv. vatt, in^l ^ 

jApm. Aslep.T^. drvM«4a. ttVoO, aftkin. j 

! 

[ap^. Wavs.l^, ziM. aki^ bwtieg. 'I 

JmnaK \ 


\mal Na. Itf . ndim, msym , 

jbynieo. IFATT. NFUT. AoU, Aspc. Agon. \ 
lAlfp, NNP. NP2. NC2, rioba. NCSYS. NSYS, t 
InCSEA. NFSa MTOP. KTRK, itrlcO. SYS. I 
;SEA.FSaRES.CTSYS.CTBEA,CTFSa ) 
•CTRES, WV. WVgen. WVirt. WVoW. fcjse, J 
l*£W^aG«?iL J 


subroutme f«.c]dgfd, lalBn. NOiv.fliina.«^^ 1 

•btedeg. IFATT. NFUT. Aoen, NNP. NP2. J 
InC 2. Blobo. NCSYS. HSYS. NCSEA, NFSa i 
!MTOP.NTRK.llfW.SYS.SeA.FSaneS. ; 
JCTSYS. CTSEA, CTFSa CTRES. VWgan, J 

irm^B I 

subroutine fR."lWp7 HOI NCSYS ^ 

-i* 

WFFttmfy 

subroutine; 

aboBMaryi2ir, 

«4tr, i6lr. oidl. 

&onl2 

subroutine 

subroutine 4^ itNcm. sMnl • 

J 

WFFKirafy 


also Bifafy i2(r. 
r4syn. fftisyti. 
onfl.AonC 

subroutine NOlvrNfiK 

subroutine *~qtiroe. 4|dBt. NOfV. Aspc. A^ Alfp. WVirtt. J 
InP2. NFSR NTOP. MTRK. »W. «6S. IRAGi 

I ' 











TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: October 1, 1993 

Subject: Change Control Status for AIF Processing Module 

By this memo, the NASA Radar Altimeter Instrument File processing module is considered baselined and 
is placed under change control; changes to any of its routines will be handled according to the TOPEX 
Software Development Team (SWDT) change control policy (slated below). 

Attached is a summary of the functions performed by the module, the database structures, a sample of the 
standard products generated, and a list of the source code and data files affected. 


SWDT Change Con trol Policy 

Any changes to SWDT baselined software, under change control, will be handled according to the 
following process: 

1. A memo describing the requested change will be generated and circulated to all members of the 
TOPEX Algorithm Development Team (ADT), and to the SWDT (for implementation 
comments). 

2. The memo will be discussed at a meeting (regular or special) of the ADT, at which time any 
special implementation comments (from the SWDT) will be considered. If the change is 
approved by the ADT, a priority will be assigned. The process will not proceed beyond this step 
until ADT approval is secured 

3. An SWDT Work Request will be generated, signed by the NASA SWDT manager, and attached 
as a cover to the original memo. 

4. The SWDT request will be given a title, EA S/W C!hg #, and processed in the normal manner. 

5. When the request is completed, a brief memo will be generated by the SWDT to summarize the 
change, to date the change (the date when implemented and the date when the change will 
appear in the data), and to list the affeaed routines and data files. Any new or modified 
products will be attached, if applicable. The implementation memo will be delivered to all 
members of the ADT, and the process will be complete. 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To : 
From; 
Date: 
Subject; 



CSC/^ayi^en Goi^on 
CSC/ 

October 01, 1993 
AIF Processing. 


Attached are listing of the database structures and sample output products from the 
Altimeter Instrument File daily processing. The processing methodology, database 
structure, processing software, and plotting software is hereby under change control. 
No modifications, additions, or deletions will be made to this system without the 
proper (TBD) authorization. 

Processing Methodology. 

1. Daily, data is retrieved automatically from JPL starting at SAM Eastern Time. 

2. Daily, dpTelem is automatically run on the retrieved data and produces the 
following output files : 

a. Event file listing. 

b. 5-min Engineering Averages for daily plotting. 

c. 1-min Science Averages for daily plotting. 

d. Average CAL Mode differences for plotting & database. 

e. 1-Hour Engineering Averages for database. 

f. Pleader (Processing summary) listing for printing & database. 

3. Daily, various programs are automatically run in IDL to produce the following 
output products : 

a. Event listing. 

b. Daily Engineering plot. 

c. Daily Science plot. 

d. Daily CAL plot. 

e. Daily Processing Summary plot. 

4. At the beginning of each week, database files are loaded into the master database 
and the following output products are generated : 


a. Launch-to-Date Engineering. 

b. Launch-to-Date CAL. 


Attached are listing of the database structures and sample output products. 

Attachment A contains the structure of the databases. Attachment B contains sample of 
the daily products. Attachment C contains samples of the Weekly products. Appendix 
D is a list of software and datafile titles put under change control by this (or some 
previous) memo. 


To : CSC/Hayder^G^don, CSC/Dennis Lockwood 

From: CSC/Jeff 

Date: October 06, i^3 

Subject: Suggested Correction to ADF Processing. 

Software Developmerit Team 
TOPEX Project 
NASA GSFC/WFF 


In running a memory dump requested by D. Hancock on the day 278 partial . 
Instrument File, I noticed that the memory was changing. This threw me into a 
panic and I started debugging a COPY of dotelem. This debugging has uncovered 
a potential problem, but it was not the problem I had origiitally attempted to trace. 

There was/is no problem with the memory dump. The memory dump was not 
changing because the altimeter was dumping a portion of memory that did not 
change. However, in debugging, I noticed that if memory did not change, memory 
did not get compared with the ROMMap reference. This design goal was to speed 
processing by reducing redundant memory comparisons, but the implemention is 
wrong because it checks the Memory Dump and not the Memory Dump Address 
for a change. This has the effect of bypassing the memory comparison when 
consecutive memory dump locations contain the same memory pattern. The 
implementation should check the Memory Dump Address, not the actual memory 
dump for changes. This correction is the recommended change. 

In practice, this should not present a problem because the memory that is 
compared rarely, if ever, contains the same bit patterns. However, whereever 
there is potential for a problem, a problem usually occurs. Since dotelem is 
change-controlled software, this memo is to advise the team of a potential problem 
and offer a suggested correction. A software change notice will be required in 
order to fix the problem. 



This Page Intentionally Left Blank 



TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe. George Hayne, David Hancock 

From: Hayden Gordon 

Date: December 9, 1993 

Subject: EA S/W Chg 4; Memory Map 

Atuched is a memo Erom David Hancock requesting a change in the baselined AIF processing module ^ 
account for a revision in the on-board memory mrq) (Pulse (2ount Refresh standard patdi). This change, 
designated Engineering Assessment Software Change Request 4, has been completed. The modification 
was made on December 8, 1993, with the release of Version 1.3 of the datafile containing the on-board 
memory map, Dataftle.ROMMap. The change became effective with data processed beginning December 
9 (1993343). No routines within the program 'dotelem' were affected. The change in the memory map 
was tested in conjunction with EA S/W Chg 5 (correction of Memory Dump verification logic) using 
Altimeter Instrument File data from Day 341; as anticipated, no changes were detected. A further test 
was run using older data (1992323), and the absence of the Pulse Count Refresh patch was properly 
detected. No standard output products were modified by the change. 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: December 9, 1993 

Subject: EA S/W Chg 5: Memory Dump Address 

Attached is a memo from Jeff Lee requesting a change in the baselined AJF processing module to 
account for an improper implementation of the Memory Dump processing logic. This change, designated 
Engineering Assessment Software Change Request 5, has been completed. The modification was made 
on December 8, 1993. with the release of Version 3.4 of the AIF processing module. The change became 
effective with data processed beginning December 9 (1993343). The routine, CheckEng.f. within the 
program ’dotelem’ was affected. The change was tested in conjunction with EA SAV Chg 4: Memory Map 
Modification. No standard output products were modified by the change. 

Thanks, 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


This Faae Inlentionall 



Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To : CSC/Hayden Gordon 

From: CSC/Dennis Lockwood, CSC/Jeff Lee 

Date: December 09, 1993 

Subject: Emergency TOPEX AIF Processing change 
request. 


I request emergency authorization to switch from DECNET to FTP software for copying 
Altimeter Instrument Files from JPL. We have been having problems for a couple of 
weeks with the transfer process. 

We carmot reliably transfer the Science data (100MB) and this causes our automated 
processing to fail. We are having to do this process by hand and we have generally 
been 1-4 hours late getting the data out. The recent power outages (and we are going to 
have another this weekend !!!) are only comjx)unding the problem. 

D. Hancock has been in contact with personnel at JPL and NSI and the suggestion is to 
use FTP rather than DECNET since FTP is generally assumed to be "more reliable." 

The software to implement the FTP procedure has been written and tested. It only 
needs to be renamed in order to put it into production. 
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TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock 

From: Hayden Gordon 

Date: December 9, 1993 

Subject: EA S/W Chg 6: JPL/WFF File Transfer 

Atuebed is a memo from Jeff Lee and Dennis Lockwood requesting an emergency change in the 
baselined AIF processing. This change, designated Engineering Assessment Software Change Request 6, 
has been completed. The modification was made on December 9, 1993, with a revision to the UND( 
script file, 'autoaif. The change will become effective with data processed beginning December 10 
(1993344). No standard output products were modified by the change. 

Thanks, 


CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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Software Development Team 
TOPEX Project 
NASAGSFC/WFF 


To : CSC/Hayden Gordon 

From: CSC/Deni\is Lockwood, CSC /Jeff Lee 

Date: December 09, 1993 

Subject: FINAL JPL SPAT Displays and Irtstrument File 
Retrieval & Processing Instructions. 


Requested JPL SPAT Display and AIF File Retrieval & Processing Instructions have 
been revised and are attached. 

User testing with the JPL SPAT Display Instructions has shown that the user needs to 
pay close attention to the keypresses required. Pay particular attention to the difference 
between [return] and [enter] and the [PFxx] and [^x] keys. Also note that sometimes 
the JPL machines and/or the network is slow and keypresses do not immediately illicit 
a response. When in doubt, read the screen. 

User testing with the Standard and Special Processing Instructions has shown the need 
to clarify the difference between the fileutc and utctime variables used in the 
Instructions, fileutc is the time used in the creation of the filename at JPL. It is used 
primarily to build filenames, utctime is used for selecting portions of data to work with 
from within dotelem. 
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JPL SPAT Display Instructions 


1. Launch the TCP/Connect II application by double-clicking on its icon. 

2. For EACH display you wish to view, perform steps 3 through 11. 

3. Under the Terminal menu at the top of the screen, select Connect. 

4. In the Session Name text field, type 128.149.96.13 and either press the 
[return] key or click the OK button. 

5. Press the [return] key once to get TGSA's attention. 

Enter a uBemame and press the [return] key at the Username: prompt. 
Enter a password and press the [return] key at the Password: prompt. 


TCP/Connect II VT102 Emulation Keys 


Mac Keyboard 

enter 

[enter] on numeric keypad 

PFl 

[clear] on numeric keypad 

PF2 

[=] on numeric keypad 

PF3 

[/] on numeric keypad 

PF4 

[*] on numeric keypad 

KPO 

[0] on numeric keypad 

KPl 

[1] on numeric keypad 

KP2 

[2] on numeric keypad 

KP3 

[3] on numeric keypad 

KP4 

[4] on numeric keypad 

KPS 

[5] on numeric keypad 

KP6 

[6] on numeric keypad 

KP7 

[7] on numeric keypad 

KPS 1 

[8] on numeric keypad 

KP9 

[9] on numeric keypad 

KP. 

[.] on numeric keypad 

Up 

[T] on cursor keypad 

Down 

[-1] on cursor keypad 

Left 

[4-] on cursor keypad 

Right 

[-4] on cursor keypad 


















8. Follow on-screen instructions until you get to the tcCS main menu. 

9. Press the [enter] key on the numeric keypad to access the telemetry menu. 

10. FoUow Step 10a to choose from a list of displays, or Step 10b to view a "standard 
display. 

10a Press the [Down] key three times to hiUght TLM3 view channel data (LIST 
OF DISPLAYS). 

Press the [enter] key to select this choice. 

Press the [KP.] key. 

Type SPAT* in resp>onse to Where DISPLAY_NAME is. 

Press the [PF3] key to execute the query. 

Use the [Up] and [Down] keys to hilight the desired screen. Note : using the [Up] 
key to scroll backwards may product strange results. 

Press the [PFl] then [KP4] keys to select your choice. The selected display should 
now be viewable on-screen. 

10b Press the [Down] key two times to hilight TML2_1 VIEW channel data - dual 
COLUMN. 

Press the [enter] key to select this choice. 

Press the [KP.] key. Type one of the following choices in resjxjnse to 
DISPLAY_NAME is. For example,.SPAT-ALTAC. 


"Standard" Displays 

Name 

Description 

SPAT-ALTAC 

ALT-A Command Words 

SPAT-ALTAD 

ALT-A Memory Dump 

SPAT-ALTAP 

ALT-A Powers 

SPAT-ALTRS 

S/C & RESET Times & SCI word 




Press the PFl and KP4 keys to confirm your choice. The selected display should 
now be viewable on-screen. 

11. You may move the display screen windows around by clicking on the title bar and 
dragging the mouse. The title bar is the area at the top of the window that contains 
"128.149.96.13" surrounded by faint lines. 

12. To exit, for each window, "back-out" of TGS system by pressing subsequent [PFl] 
then [KPO] keys. 

13. Choose the Quit menu item under the File menu to exit TCP/Connect n. 
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AIF Retrieval & 

STANDARD Processing Instructions 


Definitions 

UTC: Coordinated Universal Time. Time is represented in the format 
"YYYYDDDtHHMMSS", where YYYY represents year, DDD represents the Julian 
day of the year, and HHMMSS represents hours, minutes, and seconds. Eastern 
Standard Time = UTC Time - 5 hours. For example : 1993285t060203 represents 
October 12, 1993 at 01:02:03 EST. 

fileutc: The UTC portion of a filename. JPL aeates their AIF filenames by using 
the UTC of the start of the data. 

filename: The name of a file. Standard filenames consist of a prefix, a fileutc, and a 
suffix, where the prefix and suffix identify the file type. 

Instructions 

1 . Log on to osb3. 

2. Your path must be able to access several binaries and the IDL_PATH. 

For csh. Type: setenv PATH /gen/topex2/bin; /opt /bin ;$ PATH [return] 
For csh. Type: source /opt/lDL/idl_setup 

3. Change to the AIF processing directory. 

Typ>e: cd /ffen/topex2/aif [return] 

4. You can check to see what files are available at JPL. 

Type: Isjplaif 

5. Run the automated daily processing system. This will take approximately 1.5 
hours for a full 24-hour AIF. 

Type: stdaif fileutc 

The automated daily processing will print the following products : 

aifsci, the daily sdence product 

dailyeng, the daily single-page engineering product 

aifcal, the daily CAL mode product 

aifhdr, the processing summary 

aifevents, the events listing 


It will also create the following output files for any additional processing: 

aif_eng_/i7cutc.std, 5-minute engineering averages. 
aif_sci_/i7eufc.std, 10-second science averages. 
aif_event_/i7eiifc.std, an event report. 
aif_eng_/iZe«fc.db, 1-hour engineering averages. 
aif_cal_/i7e«fc.db, CAL mode averages. 
aif_hdr_/i7ewfc.db, a header report. 

6. If more engineering parameters need to be examined, run the idl program that 
plots all engineering parameters. 

Type: aifeng filename, where filename is of the form aif _eng_/i7eufc. std . 
7 . If other types of processing is required, see SPECIAL Processing Instructions. 



SPECIAL Processing Instructions 


Definitions 

UTC: Coordinated Universal Time. Time is represented in the format 
"YYYYDDDtHHMMSS", where YYYY represents year, DDD represents thiC Julian 
day of the year, and HHMMSS represents hours, minutes, and seconds. Eastern 
Standard Time = UTC Time - 5 hours. For example : 1993285t060203 represents 
October 12, 1993 at 01:02:03 EST. 

fileutc: The UTC portion of a filename. JPL creates their AIF filenames by using 
the UTC of the start of the data. 

filename: The name of a file. Standard filenames consist of a prefix, a fileutc, and a 
suffix, where the prefix and suffix identify the file type. 

Instructions 

1. Logontoosb3. 

2. Your path must be able to access several binaries and the IDL_PATH. 

For csh, Typ>e: setenv PATH /gen/ topex2 /bin : /opt /bin : $PATH [return] 
For csh. Type: source /opt/IDL/idl_setup 

3. Change to the AIF processing directory. 

Type: cd /gen/topex2/aif [return] 

4. You can check to see what files are available at JPL. 

Tyf)e: Is jplaif 

5. If you haven't already retrieved the data, retrieve the Engineering Instrument File. 
Type: get jplbin '14.429: tWPFDEV: [WFFDSER .WFF_DATA]/t7eMamfe(return] 
Whete filename is of the format tcc_alteng_/e7eMtcbin 

( 24 hours of data takes approximately 5 minutes to retrieve ) 

6. If you haven't already retrieved the data, retrieve the Science Instrument File. 

Type: get jplbin '14.429 : tWFFDEV: [WFFUSER.WFF_DATAl/i7enamt(return] 
VJheie filename is of the format tcc_altsci_/i7etttcbin 

( 24 hours of data takes approximately 45 minutes to retrieve ) 

7. dotelem requires UTC Seconds for time selections. If you wish to do a time 
selection and don't know UTC Seconds, run utcconvert to convert from UTC Clock 
Time to UTC Seconds. Remember, Eastern Standard Time = UTC Time - 5 hours. 



Convert the start time. 


Type: utcconvert 

Tyf>e: 2 [return] in response to Select DTC Time to Enter 
Typ>e: UTC in response to Enter UTC in the format YYYYDDDtHHMMSS 
Write down the time in seconds. You won't be able to remember it. 

Type: [return] in response to Press RETURN to Continue 

Convert the stop time . 

Type: 2 [return] in response to Select UTC Time to Enter 
Typ>e: UTC in response to Enter UTC in the format YYYYDDDtHHMMSS 
Write down the time in seconds. You won't be able to remember it. 

Typ>e: [return] in response to Press return to Continue 

Tyf>e: X [return] in response to Select UTC Time to Enter in order to exit. 

8. Run dotelem. Follow the on-screen menus to select what processing you wish to 
perform. Note that selecting by Latitude/Longitude does not work. The names of 
the output files will be printed on the screen after your processing selections are 
complete. They will also be written into an aif_???.log file. Write down the output 
filenames and wait until processing is complete. 

Type: dotelem and follow on-screen instructions. 

Typ>e: x [return] in response to Enter File Type to exit. 

9. Use the following table to choose what output command corresponds to your 
processing selection. Run that conrunand by typing it. 


Table of Processing Selections & Output Commands 


Processing Selection 

Output Command 

Description/Comment 

0. Do Standard Processing 

n/a 

Previously documented. 

1. Create AIF Databases 

n/a 

No output commands 
available. 

2. Dump Telemetry 

1 ! 

n/a 

j 

Load into spreadsheet of view 
on-screen. 

3. Average Science Data 

i 

aifsci filename 

Plot science data. 

4. Average Engineering Data 

i 

aifeng filename 

Plot all engineering data. 

1 i 

i : 

daily eng filename 

Plot single-page selected 
engineering data. 

5. Average Waveform Data 

topexautowf filename 

Plot auto-scaled waveforms. 


topexwf filename 

Plot fixed-scale waveforms. 

6. Report Status Changes 

n/a 

Print or view on-screen. 

7. Create SDR 

n/a 

No output commands 
available. 
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Software Development Team 
TOPEX Project 
NASAGSFC/WFF 


To: 

From: 

Dale: 

Subject: 


CSC/Hayder\ Gord^ / 

CSC/Dennis CSC^/effLee 


January 20, 1994 ^ 

RE: Change Request for AIF Processing Module: 
Cal Plot Change. 


I recommend we modify the request to state that only the last 7 (or 14) days of cal data 
be plotted. It is too hard to keep track of the last date the plot was printed. 

This change will require the modification of the following change-controlled software: 
topexcal.pro (IDL software) 

This change will require the recompilation of the following change-controlled software: 
-none- 
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Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: CSC/HaydeaGomon /if'' 

From; CSC/Dermi&Tjy0|^yJ^c5m, CSC^^ 

Date: January 24, 1^4 ^ 

Subject: RE; Change Request for AIF Output of Last Reset 
Time - Revisited. 


In prototyping methods for displaying the Hex values of the Time_Last_Reset, I will 
propHDse another method of making this change. I have already written code to read the 
event file and count the number of occurrences of a certain event (due to another 
request). I can also detect the occurrence of a Time_Last_Reset event. There is a 
problem in converting from the Time in seconds (which is currently displayed) to the 
Time in Hex. Thus, I propose the following: 

The doTelem module EngStatus will be modified to print out the Time_Last_Reset in 
hexidecimal as well as seconds. IDL software, ReadEvents, will be modified to read the 
time in hex and dbheader will be modified to display the results. 

This change will require the modification of the following change-controlled software; 
dbheader (IDL software) 
readevents (NEW IDL software) 

This change will require the recompilation of the following change-controlled software: 
EngStatus (doTelem) 
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Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: CSC /Hayden Gordon 

From: CSC/Dennis Lockwood, CSC/Jeff Lee 

Date: January 25, 1994 

Subject: RE; Request #94/010. 


Per request number 94/010 change-controlled software and/or procedures have been 
modified. 



1. doTelem 3.5, 01/24/94 



1. EngStatus.f modified(doTelem) 



1. aifhdr.pro modified 

2. reade vents -pro modified 



none 
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Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To : CSC /Hayden Gordon 

From: CSC/Dennis Lockwood, CSC/Jeff Lee 

Date: January 25, 1994 

Subject: RE: Request #94/007. 


Per request number 94/007 change-controlled software and/or procedures have been 
modified. 



1. doTelem 3.5,01/24/94 

2. DataFile.EALimits 07,01/26/94 



1. wfdiff.pro 


2. readevents.pro 

3. aifhdr.pro 


created 

created 

modified 



1. dailyaif.pro modified 

2. finishaif.pro modified 

3. stdaif.pro modified 

4. dailywf created 


5. wfdiff 

6. wfdiffall 

Modifications to Databases 

1. wfhi.dbase 

2. wflo.dbase 


created 

created 


created 

created 




To: CSC /Hayden Gordon 

From: CSC/Dennis Lockwood, CSC/Jeff Lee 

Date: January 25, 1994 

Subject; RE: Request #94/008. 

Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


Per request number 94/008 change-controlled software and/or procedures have been 
modified. 

Effective Date: 1/25/94 

Version Numbers 
none 

Modifications to Procedures. 

1. Information must be received from Hancock or Purdy. 

2. Lockwood wil keep log up-to-date. 

Modifications to FORTRAN source code 
none 

Modification to Datafiles 
none 

Modifications to IDL code 

1. readseu.pro modified 

2. topexseu.pro modified 

Modifications to UNIX script files 
none 

Modifications to Databases 


none 
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To : CSC/Hayden Gordon 

From; CSC/Dennis Lockwood, CSC/Jeff Lee 
Date: January 25, 1994 

Subject: RE: Request #94/011. 

Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


Per request number 94/011 change-controlled software and/or procedures have been 

modified. 

Effective Date: 1/25/94 

Version Numbers 
none 

Modifications to Procedures. 
none 

Modifications to FORTRAN source code 
none 

Modification to Datafiles 
none 

Modifications to IDL code 

1. aifcal.pro modified 

Modifications to IJ ND( script files 

1. dbcal modified 

Modifications to Databases 


none 
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TOPEX Interoffice Memo 


I 

I 

^ From: 

Date: 

I Subject: 


Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 
Hayden Gordon 
February 1, 1994 

EA SAV Chg 10: Last Reset Time of Day 


Attached is a memo from David Hancock requesting a change in the baselined AIF processing module, 
with a modification to the standard output products to include the last Reset Time encountered during a 
single day. This change, designated Engineering Assessment Software Change Request 10. has been 
completed. The modification was made on January 25, 1994, with the release of Version 3.5 of the AIF 
processing module, and became effective with data processed January 26, 1994. The changes are 
summarized in the attached memo from Dennis Lockwood and Jeff Lee, 


Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: February 1, 1994 

Subject: EA SAV Chg 7: Waveform Monitoring 

Attached are two memos from David Hancock requesting a change in the baselined AIF processing 
module. This change, designated Engineering Assessment Software Change Request 7, has been 
completed. The modification was made on January 25, 1994, with the release of Version 3,5 of the AIF 
processing module, and Version 7 of the file DataFile.EALimits. The change became effective with data 
processed beginning January 26, 1994. The routines affected and the new data products being generated 
are summarized in the attached memo from Dennis Lockwood and Jeff Lee.. 


Thanks, 

CC; Jeff Lee, Dennis Lockwood, Carol Purdy 
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TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: February 1, 1994 

Subject: EA SW Chg 8: SEU Monitoring 

Attached is a memo from David Hancock requesting a change in the production processing. This change, 
designated Engineering Assessment Software Change Request 8, has been completed. There was no 
modification to any baselined software, but a new procedure has been established and put under change 
control. The new procedure became effective January 25. 1994, and is summarized in the attached memo 
from Dennis Lockwood and Jeff Lee. Please note that the source of data for this process is David 
Hancock or Craig Purdy. 

Thanks. 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: February 1, 1994 

Subject; EA SAV Chg 1 1 : Cal Plot Change 

Aiiached is a memo from David Hancock requesting a change in the baselined AIF processing module, 
with a modification to the standard output products to include only data since the last plot on the standard 
Cal plot Since there is no way to know when the last plot was produced, the request was modified by the 
ADT to include only the last 14 days of Cal dau. This change, designated Engineering Assessment 
Software Change Request 1 1, has been completed. The modification was made on January 25, 1994, and 
became effective with data processed January 26. 1994. The changes are summarized in ihe attached 
memo from Dennis Lockwood and Jeff Lee. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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TOPEX Interoffice Memo 


To; Ron Brooks, Ron Forsythe, David Hancock, George Hayne, Craig Purdy 

From: Hayden Gordon 

Date: March 21, 1994 

Subject: EA S/W Chg 9: Error Reset Mnemonics 

Attached is a memo from David Hancock requesting two additional mnemonics be added to the 
mnemonic look-up file, DataFile.CMD. This change, designated Engineering Assessment Software 
Change Request 9, has been completed. The modification was made on March 11, 1994, with an addition 
to the look-up file, and became effective with data processed March 11, 1994. 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


We have had two new commands added to the TOPEX library at JPL. It is 
requested that the following mnemonics be added to the WFF Altimeter 
Command Mnemonic file: 

0F7F AERRORST Error reset; side A 
0B7F BERRORST Error reset; side B 

David Hancock hancock@osbl.wff.nasa.gov 


To: David Hancock and Craig Purdy 
From: Ron Brooks and Jeff Lee 
Date: May 26, 1994 

Subject: Temperature Corrections for Side-B CAL-1 Ku and C AGC 


OVERVIEW 


Temperature corrections have been derived for Side-B CAL-1 Ku and 
C AGC values, based on pre-launch test data. The form of the 
additive AGC temperature correction for each band is (a + bT] , 
where a and b are coefficients and T is temperature. This 
correction is for a fixed attenuator in the calibration path; 
this attenuator is not in the normal AGC operation path. 

For Ku-band, a = -3.620 dB, b = +0.127 dB/deg, and T is the Ku 
MTU Calibration Attenuator Temperature. The value of "a" is 
based on an anticipated on-orbit nominal temperature of 28.5 
degrees, the same as for the on-orbit Side A. 

For C-band, a = -2.133 dB, b = +0.079 dB/deg, and T is the C MTU 
Calibration Attenuator Temperature. The value of "a" is based on 
an anticipated on-orbit nominal temperature of 27.0 degrees, the 
same as for the on-orbit Side A. 

These temperature corrections do not apply to CAL-2 data. 


PROCEDURES 


The procedures to derive these coefficients were as follows. 

RASE tapes for April 1992 were loaded and processed using 
standard AIF processing software. This software performs T3117 
temperature corrections and subtracts references from processed 
CAL data; however, a special override file was used to disable 
the standard CAL attenuator temperature corrections . 

The processed RASE data were entered into a temporary database, 
and Ku and C CAL data for Step 5 were extracted. The Step 5 data 
were separated into Side A and Side B, and suspect data were 
deleted. The remaining Ku and C AGC data were linearly fit to 
the respective Ku and C Calibration Attenuator Temperatures. The 
plots depicting these linear fits are attached. 

To assess the technique described above, the Side A Ku and C CAL- 
1 RASE data were linearly fit to the Calibration Attenuator 
Temperatures. The derived temperature corrections for Side A 
agreed with those in current use to within 0.01 dB per degree. 



RECOMMENDAT IONS 


It is recommended that these CAL-1 AGC temperature-correction 
coefficients for Side B be implemented in the WFF AIF processing 
software. Minor coefficient tweaking may be required after Side 
B becomes operational and on-orbit Side B CAL data are analyzed. 


cc : 

George Hayne 
Ron Forsythe 
Larry Rossi 
Hayden Gordon 
Jeff Lee 
Dennis Lockwood 
Carol Purdy 
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Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


To: CSC/Hayden Gordon I / ^ 

From: CSC /Dennis Lockyrofe^^<3Cj^ 

Date: May 27, 1994 (y 

Subject: Suggested Correction to AIF Processing. 


George Hayne has discovered an error in the full-rate waveform routine of 
dotelem. When writing full-rate waveforms, the incorrect value of CAL Step is 
output. 

We recommend that the AIF processing module, dogtelem be modified to write 
out the correct CAL Step during full-rate waveform processing. The fix is a very 
simple one and only requires changing a variable name in the write statement. No 
products will be modified . 

Since dotelem is change-controlled software, this memo is to advise the team of a 
problem and offer a suggested correction. A software change notice will be 
required in order to fix the problem. 
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TO: Hayden Gordon 
FROM: Ron Brooks 
DATE: June 3, 1994 

SUBJECT: Implementation of Temperature Correction Coefficients 

for Side-B CAL-1 Ku and C AGC 

REFERENCE: 5/26/94 Memorandum from R. Brooks and J. Lee, 

Temperature Corrections for Side-B CAL-1 Ku and C AGC 


I recommend that the coefficients for Side-B CAL-1 Ku and C AGC 
temperature corrections be implemented in the WFF AIF processing 
software. The derivation of the coefficients is described in the 
referenced memorandum. 

The form of the additive AGC temperature correction for each band 
is [a + bT], where a and b are coefficients and T is temperature. 
This correction is for a fixed attenuator in the calibration 
path; this attenuator is not in the normal AGC operation path. 

For Side B Ku-band, a = -3.620 dB, b = +0.127 dB/deg, and T is 
the Ku MTU Calibration Attenuator Temperature. For Side-B C- 
band, a = -2.133 dB, b = +0.079 dB/deg, and T is the C MTU 
Calibration Attenuator Temperature. 


cc : 

David Hancock 
Craig Purdy 
George Hayne 
Ron Forsythe 
Larry Rossi 
Jeff Lee 
Dennis Lockwood 
Carol Purdy 
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Draft TOPEX INFORMAL MEMORANDUM 


28 June 1994 

SUBJ; Corrections to Range Bias Determined in TOPEX Calibration Mode 1 

FROM: G.S. Hayne 

TO; R.L. Brooks, R.G. Forsythe, H.H. Gordon, D.W. Hancock III, J.E. Lee, D.W. 

Lockwood, C.L. Purdy, L.C. Rossi 


The TOPEX altimeter's Calibration Mode 1 ("Cal-l") gives data on possible range drift in the 
altimeter. The Cal-l measurements are contaminated by the finite size of the least significant bit 
G.s.b.) for the word positioning the altimeter's Digital Filter Bank (DFB). In this memo I discuss 
how to correct the TOPEX Cal-l range bias estimates for the 7.32 mm l.s.b. effects. This is a 
brief memo, to be expanded soon into a more complete document addressing both the range and 
the 0 ° corrections indicated by the TOPEX altimeter's Calibration Modes. 

Cal-l has a number of individual steps, each having different AGC levels, and there is a range 
estimate for the ~10 seconds spent in each step. In general, a Calibration Mode is executed 
approximately every half day. Figure 1 shows the launch-to-date Calibration database results for 
the Ku-band range estimates from Cal-l Step 5, the step which probably best represents typical 
AGC levels for normal ocean fine-track operation. 


Figure 2 shows the full-rate range data for a portion of the Cal-l on 1992 day 348. Notice the 
regular sawtooth oscillation of these data. The average of all of the Step 5 data in Figure 2 is a 
single point plotted on Figure 1. The Cal-l pulseshape being tracked is almost a completely 
deterministic signal, having none of the speckle noise which is so typical of a normal, over-ocean 
radar return. The regular sawtooth oscillation occurs because the deterministic signal is tracked 
by a loop in which the DFB is positioned by 7.32 mm increments, the l.s.b. of the fine height word 
within the altimeter. Figure 3 sketches the range tracking loop for Cal-l. The range accumulator 
R can be regarded as a continuous variablCj unlike the position Q of the DFB with its position 
l.s.b. of 7.32 mm. 
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The Cal-1 range tracking is easily simulated, using the Cal-1 recursion relation 
R, = R„., + ct- AR „.2 , where 

ar„ = t,-q„, 

in which T„ is the true range, and Q„ is the value of R„ as quantized by the 7.32 mm l.s.b. For the 
nearly noise-free transmitted pulseshape being cracked, we can assume zero error in the 
waveform-based estimate of the AR^. Figure 4 shows simulation results for Cal-1 tracking of a 
range which decreases linearly with time, and Figure 5 shows just a part of Figure 4. In Figures 4 
and 5, the quantity Raccum or Race is the altimeter’s range R as described by the recursion 
relationship above. Notice the behavior of Figure 5 as the Rtrue crosses the quantization levels 
21.96, 14.64, and 7.32 . The Cal-1 data of Figure 1 from the start of Cycle 009 to the present 
correspond to data between two of the quantization levels. The small change of about -1.5 mm 
over 540 days in Figure 1 is an underestimate of the tnie drift, just as the R for updates 120 to 
330 in Figure 5 would produce an underestimate of the change in Rtrue. 

Notice in Figure 5 that the appearance of the R sawtooth changes as a function of the distance of 
Rtrue from the next lower quantization level. I have extended the simulation work, replacing the 
continuously changing Rtrue of Figures 4 and 5 with a set of different constant Rtrue values. For 
each Rtrue, the simulation is run for a large number of tracker update cycles, and I form average 
values for R and for a ratio Q, = N„p / N„p is the number of range updates for which R^ is 
greater than R„.„ and N*„„ is the number of range updates for which R„ is less than R„.,. Then I 
defined an additive range correction dR' = AveragefRtrue - R + 3.66) mm. This dR’ will be zero 

I 

when Rtrue is about halfway between one quantization level and the next The extended 
simulation results allow dR' to be expressed as a fitted function of Q, by 

dR’ = 0.02910 - 1. 34369- ATAN[1.03325 Ln(Q,) - 0.01 174] mm, 
and the simulation input points and fitted curve are shown on Figure 6. 

As a rough check on what the effect of the dR' coirection will be, I selected portions of four 
different Cal-1 Modes, each separated by about 180 days. Figure 7 shows the average Cal-1 
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ranges before the quantization correction, and Figure 8 shows the results after the quantization 
correction dR'. The Figure 8 ranges decrease more rapidly with time than do the Figure 7 ranges 
The same procedure was used to correct the C-band Cal-1 ranges which also decrease with time. 
Finally, Figure 9 shows the combined Ku- & C-band ranges from the several Cal-1 steps. Figure 
9 suggests that the TOPEX ionosphere-corrected range measurement has drifted downward by 
about 5 mm in the past year and a half. 

Figures 7 - 9 are based on only four parts of Cal- 1 Modes, analyzed by hand. We are going to 
add more data to the set analyzed in this way, perhaps one Cal-1 per month as a start. The added 
data will allow some assessment of how linear the TOPEX range measurement drift is with time. 
But we already have a useful tool to remove some of the quantization-caused error in the range 
drift results, and it is now time to consider what range updates should be added to the JPL Cal 
Table and when. 

Attachment 1 is a one-page summary of the algorithm to correct Cal- 1 ranges for the DFB 
positioning quantization. 



ATTACHMENT 1. 



To be done for each step and each frequency (Ku and C) in TOPEX Cal-1 : 

1 . Skip first frame of data 

2. Initialize variables; 

a. set counter N„p = 0 

b. set counter = 0 

c set counter = 0 

d.. setR,,g = 0 

3. For first range value, r,, after the initial skipped frame 

a. set R,^g = r, 

b. set counter = 1 

4. For each successive value, r„, after the initial value r, (dq special action is 
needed in case of a missing frame) 

a. set R,,g = R^^g + r„ 

b. set counter N^g„ = N^g„ + 1 

c. if r„ > r„., , set counter N„p = N„p + 1 

d. if r„ < r„.„ set counter + 1 

5. At the end of this step in Cal-1 

a. form the average range by R^^g = R^g / 

b. ifN,^ = 0,setNdo^= 1 

c. form a ratio quantity Qr = N„p / 

d. the additive range correction for quantization effects, dR', is given by: 

dR' = C, + C2-ATAN[C3-Ln(QR) + CJ. 

e. the latest values for the four coefficients in this expression are: 

C, = +0.02910 
Cj = -1.34369 
C3 = +1.03325 
C^ = -0.01174 


Comment: Note that this algorithm includes the formation of the average range. 
The average range is already being formed in the existing Cal data processing at 
WFF, and is. included here Only for completeness. . 


Figure 1. TOPEX Cal-1 Step 5 Ku Height Data from Launch-to- 
Date Calibration Database (1 1 -point moving average trend line). 




Figure 3. Sketch of TOPEX Range Measurement in Cal-1 . 



telemetry 











Update number 

Figure 5. Simulation Study of Cal-1 Range Tracking, for 7.32 mm 


Quantization in DFB Positioning (Expanded Horizontal Scale from 
Figure 4). 









CaM reduced range, In mm 






Cal-1 reduced range. In mm CaM reduced range. In mm 


Figure 8. TOPEX Ku Cal-1 Range Drift from Cal Database After 
Correction for 7.32 m,m l.s.b. of DFB Position. 



Figure 9. TOPEX Combined Ku & C Cal-1 Range Drift After 

Including Correction for 7.32 mm l.s.b. of DFB Position. 
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07 July 1994 

SUBJ: Replacement Figure 3, for DRAFT Memo "Corrections to Range Bias Determined in 

TOPEX Calibration Mode 1 " of 28 June 1994 
FROM; G.S. Hayne 

TO: R.L. Brooks, R.G. Forsythe, H.H. Gordon, D.W. Hancock III, J.E. Lee, D.W. Lockwood, 

C.L. Purdy, LC. Rossi 


There was an error on Figure 3 of the indicated memo. The original Figure 3 misidenrified the fine height 
word's least significant bit as 0.732 mm, but the correct value is 7.32 mm. The attached replacement 
Figure 3 corrects this error. 

I have also attached a figure showing the TOPEX ideal point target response and replica of that response 
displaced 7.0 mm lower in range. Recall that our estimate of Ku Cal- 1 range drift was about 6 mm, so 
this figure shows something like the maximum Cal-1 track point difference over the mission to date. 
Because the horizontal axis of the figure is in units of sample gate spacing, the TOPEX waveform 
samplers in Cal-1 tracking will be at positions ±0.5, ±1.5, ±2.5, and so forth. The actual point-target 
response is very nearly identical to the ideal response shown on this figure. 



Chart4a.SINCJUNK.XLS, prlnJod 3:26 PM. 7/S/94 



TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

F rom: Hayden Gordon 

Date: September 21, 1994 

Subject: EA S/W Chg 15: AIF Waveform Processing Correction 

Attached is a memo from Dennis Lockwood & Jeff Lee which addresses an error in the implemented full- 
rate waveform routine of 'dotelem' within the basehned ABF processing module. This change, designated 
Engineering Assessment Software Change Request 15, has been completed. The AIF processing module, 
dotelem. was modified to write out the correct CAL step during full-rate waveform processing. The 
change was made and implemented on 9/16/94; the new version of dotelem is 3.6. No output products 
were changed, and none are attached. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 


This Page Intentionally Left Blank 



TOPEX Interoffice Memo 


Ron Brooks. Ron Forsythe, George Hayne, David Hancock, Craig Purdy 
Hayden Gordon 
September 21, 1994 

EA S/W Chg 20: Side B Temp Coir Coeffs 

Attached is a memo from Ron Brooks which addresses the implementation of Side B, CAL-1, Ku & C 
AGC temperature corrections in the baselined AIF software. This change, designated Engineering 
Assessment Software Change Request 20, has been completed. The change was made by revising the 
Engineering Limits file, DataFiJe.EALimits, which was completed on 9/16/94; the new version of the file 
is 8. No output products were changed, and none are attached. 

Thanks, 

CC: Jeff Lee, Dennis Lockwotxl, Carol Purdy 


To: 

From: 

Date: 

Subject: 
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TOPEX Interoffice Memo 


To: Ron Brooks, Ron Forsythe, George Hayne, David Hancock, Craig Purdy 

From: Hayden Gordon 

Date: September 21, 1994 

Subject: EA S/W Chg 19: New CAL Processor 

George Hayne has developed a better method for processing CAL mode data (reference Hayne memo, 
'‘Corrections to Range Bias Determined in TOPEX Calibration Mode 1”, dated June 28, 1994). The 
algorithm has been implemented and tested by the SWDT (SWDT Request #94/086). It is requested that 
the algorithm be made a permanent part of the AIF processing. This change, designated Engineering 
Assessment Software Change Request 19, has been completed. The change was made and implemented 
on 9/16/94; the new version of dotelem is 3.6. No output products were changed, and none are attached. 

Thanks, 

CC: Jeff Lee, Dennis Lockwood, Carol Purdy 
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To : CSC / Dennis Lockwood 

From: CSC /Jeff Lee 

Date: January 17, 19^ 

Subject: RE> Request 94/193 

Software Development Team 
TOPEX Project 
NASA GSFC/WFF 


In response to Request#94/143, changes have been made to the following components 
of the AIF processing system; 

DataFile.EALimits Version 9.0, 01/17/95 Changed WF Limits per Memo 

aifcal no version number Changed AGC Scales 

All changes are completed and new software is in place as of 01/17/95. 
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To: CSC /Hay den Gordon 

From: CSC/Jeff Lee 

Date: February 24, 1995 

Subject: Change Request 95/045 

Software Development Team 
TOPEX Project 

NASA GSFC/WFF 

In response to Change Request 94/045 modified components of the AIF processing 
software have be placed into service. These modifications may be broken down into 
three distinct areas of functionality; Pass Count; Memory Map; and CACQ Waveform 
Processing. Changes made in each area are detailed below. A summary of version 
information is included at the end. 

Pass Count : Study Request 95/004 

Pass Count processing is a change implemented in the event processing of dotelem. 

New PassCount processing follows: 

Write error message to event log if last PassCount ^ current PassCount 

Memory Map: Study Request 95/019 

A large part of RAM has been added to the memory which is checked during dotelem 
processing. Memory checking code was also modified to only check memory when the 
EngMemChksum matches the current reference value (FC55). The new memory 
references were added to DataFile.ROMMap and the EngMemChksum reference value 
was added to DataFile.EALimits. 

CACQ Processing : Study Request 95/003 

A new process was added to dotelem to perform CACQ waveform checking. 
Implemenation of this process necessitated a change to the format of the waveform 
databases and, additionally, changes to the STBY and CAL2 waveform processors. 
Cor\stants for AGCKu limits were added to DataFile.EALimits. Additional code was 
added to the dotelem events processor to alarm if initial CACQ AGCKu value was out 
of limits. CACQ waveform processing follows: 

Until end of science data. 

Each science record is checked for validity. A record is corisidered valid if Model = 
Mode2 = CACQ. If not valid, another science record is read. 

AGCKu is checked to be within the required range. (Currently 36-42 dB). If 
AGCKu is not within range, another sdence record is read. 



•values for waveforms 3,4, and 5 are added to accumulated high rate data 
•values for waveform 2 are added to accumulated low rate data 
•temperature from AGC Receiver Section Monitor is added to temperature data 

Upon end of science data, accumulated data is averaged and written to 
appropriate Hi & Lo waveform files. 

Version Information 

The following versions of each changed software component follow: 

dotelem 4.0, 2/10/95 

DataFile.ROMMap 2.0, 2/10/95 

DataFile.EALimits 10.0, 2/10/95 

Date effective is 2/15/95 

First Data affected is 1995046 


Abbreviations & Acronyms 


AIF 

Altimeter Instrument File 

ADP 

Algorithm Development Plan 

ADT 

Algorithm Development Team 

AGC 

Automatic Gain Control 

APL 

Applied Physics Laboratory 

CAL 

Calibration Mode or Ccilibration Mode data 

CSC 

Computer Sciences Corporation 

CNES 

Centre National d'Etudes Spatiales 

COTS 

Commercial Off-The-Shelf 

EM 

Electromagnetic 

ENG 

Engineering Data 

EU 

Engineering Unit 

FTP 

File Transfer Protocol 

GDR 

Geophysical Data Record 

GSFC 

Goddard Space Flight Center 

HDR 

Header data 

IGDR 

Intermediate Geophysical Data Record 

IDL 

Interactive Data Language 

JPL 

Jet Propulsion Laboratory 

NASA 

National Aeronautics and Space Administration 

NSI 

NASA Science Internet 

RASE 

Radar Altimeter System Evaluator 

SCI 

Science Data 

SDR 

Sensor Data Record 

SDS 

Science Data System 

SIS 

Software Interface Specification 

SDT 

Science Definition Team 

SEU 

Single Event Upset 

STR 

Selected Telemetry Record 
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Abbreviations & Acronyms 


SWDT 

Software Development Team 

SWH 

Significant Wave Height 

TGS 

TOPEX Ground System (TGSA, TGSB, & TGSC VAX Cluster) 

TMR 

TOPEX Microwave Radiometer 

TOPEX 

Ocean Topography Experiment 

UTC 

Universal lime Coordinated 

WFF 

Wallops Flight Facility 
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